Code:
/ Net / Net / 3.5.50727.3053 / DEVDIV / depot / DevDiv / releases / Orcas / SP / wpf / src / Base / System / Windows / Expression.cs / 1 / Expression.cs
using System; using System.ComponentModel; using MS.Internal.WindowsBase; namespace System.Windows { ////// Modes for expressions /// //CASRemoval:[StrongNameIdentityPermission(SecurityAction.LinkDemand, PublicKey = Microsoft.Internal.BuildInfo.WCP_PUBLIC_KEY_STRING)] internal enum ExpressionMode { ////// No options /// None = 0, ////// Expression may not be set in multiple places /// ////// Even if a non-shareable Expression has been attached and /// then detached, it still may not be reused /// NonSharable, ////// Expression forwards invalidations to the property on which it is set. /// ////// This option implies ForwardsInvalidations, ///as well. /// Whenever the expression is notified of an invalidation of one /// of its sources via OnPropertyInvalidation, it /// promises to invalidate the property on which it is set, so the /// property engine doesn't have to. /// /// The property engine does not /// need to keep a reference to the target /// in this case, which can allow the target to be garbage-collected /// when it is no longer in use. /// /// Expression supports DependencySources on a different Dispatcher. /// ////// This option implies SupportsUnboundSources } ///as well. /// When set, it suppresses the property engine's check that the /// DependencyObject to which the expression is attached belongs to /// the same Thread as all its DependencySources, and allows /// OnPropertyInvalidation notifications to arrive on the "wrong" /// Thread. It is the expression's responsibility to handle these /// correctly, typically by marshalling them to the right Thread. /// Note: The check is only suppressed when the source isn't owned /// by any Thread (i.e. source.Dispatcher == null). /// /// Expressions are used to define dependencies between properties /// ////// When a property's computed value is no longer considered valid, the /// property must be invalidated. The property engine propagates these /// invalidations to all dependents. //CASRemoval:[StrongNameIdentityPermission(SecurityAction.LinkDemand, PublicKey = Microsoft.Internal.BuildInfo.WCP_PUBLIC_KEY_STRING)] [TypeConverter(typeof(ExpressionConverter))] public class Expression { ////// /// An Expression can be set per-instance per-property via SetValue. /// /// Expression construction /// internal Expression() : this(ExpressionMode.None) { } ////// Expression construction /// internal Expression(ExpressionMode mode) { _flags = 0; switch(mode) { case ExpressionMode.None: break; case ExpressionMode.NonSharable: _flags |= InternalFlags.NonShareable; break; case ExpressionMode.ForwardsInvalidations: _flags |= InternalFlags.ForwardsInvalidations; _flags |= InternalFlags.NonShareable; break; case ExpressionMode.SupportsUnboundSources: _flags |= InternalFlags.ForwardsInvalidations; _flags |= InternalFlags.NonShareable; _flags |= InternalFlags.SupportsUnboundSources; break; default: throw new ArgumentException(SR.Get(SRID.UnknownExpressionMode)); } } // We need this Clone method to copy a binding during Freezable.Copy. We shouldn't be taking // the target object/dp parameters here, but Binding.ProvideValue requires it. (Binding // could probably be re-factored so that we don't need this). [FriendAccessAllowed] // Used by Freezables internal virtual Expression Copy( DependencyObject targetObject, DependencyProperty targetDP ) { // By default, just use the same copy. return this; } ////// List of sources of the Expression /// ///Sources list internal virtual DependencySource[] GetSources() { return null; } ////// Called to evaluate the Expression value /// /// DependencyObject being queried /// Property being queried ///Computed value. Unset if unavailable. internal virtual object GetValue(DependencyObject d, DependencyProperty dp) { return DependencyProperty.UnsetValue; } ////// Allows Expression to store set values /// /// DependencyObject being set /// Property being set /// Value being set ///true if Expression handled storing of the value internal virtual bool SetValue(DependencyObject d, DependencyProperty dp, object value) { return false; } ////// Notification that the Expression has been set as a property's value /// /// DependencyObject being set /// Property being set internal virtual void OnAttach(DependencyObject d, DependencyProperty dp) { } ////// Notification that the Expression has been removed as a property's value /// /// DependencyObject being cleared /// Property being cleared internal virtual void OnDetach(DependencyObject d, DependencyProperty dp) { } ////// Notification that a Dependent that this Expression established has /// been invalidated as a result of a Source invalidation /// /// DependencyObject that was invalidated /// Changed event args for the property that was invalidated internal virtual void OnPropertyInvalidation(DependencyObject d, DependencyPropertyChangedEventArgs args) { } ////// Dynamically change this Expression sources (availiable only for NonShareable /// Expressions) /// ////// Expression must be in use on provided DependencyObject/DependencyProperty. /// GetSources must reflect the old sources to be replaced by the provided newSources. /// /// DependencyObject whose sources are to be updated /// The property that the Expression is set to /// New sources internal void ChangeSources(DependencyObject d, DependencyProperty dp, DependencySource[] newSources) { if (d == null && !ForwardsInvalidations) { throw new ArgumentNullException("d"); } if (dp == null && !ForwardsInvalidations) { throw new ArgumentNullException("dp"); } if (Shareable) { throw new InvalidOperationException(SR.Get(SRID.ShareableExpressionsCannotChangeSources)); } DependencyObject.ValidateSources(d, newSources, this); // Additional validation in callee if (ForwardsInvalidations) { DependencyObject.ChangeExpressionSources(this, null, null, newSources); } else { DependencyObject.ChangeExpressionSources(this, d, dp, newSources); } } // Determines if Expression can be attached: // 1) If Shareable // 2) If NonShareable and not HasBeenAttached internal bool Attachable { // Once a NonShareable has been Attached, it can't be used anywhere // else again (even if it's been Detached) get { return Shareable || !HasBeenAttached; } } internal bool Shareable { get { return (_flags & InternalFlags.NonShareable) == 0; } } internal bool ForwardsInvalidations { get { return (_flags & InternalFlags.ForwardsInvalidations) != 0; } } internal bool SupportsUnboundSources { get { return (_flags & InternalFlags.SupportsUnboundSources) != 0; } } internal bool HasBeenAttached { get { return (_flags & InternalFlags.Attached) != 0; } } internal void MarkAttached() { _flags |= InternalFlags.Attached; } ////// Expression.GetValue can return NoValue to indicate that /// the property engine should obtain the value some other way. /// [FriendAccessAllowed] internal static readonly object NoValue = new object(); private InternalFlags _flags; [Flags] private enum InternalFlags { None = 0x0, NonShareable = 0x1, ForwardsInvalidations = 0x2, SupportsUnboundSources = 0x4, Attached = 0x8, } } } // File provided for Reference Use Only by Microsoft Corporation (c) 2007. // Copyright (c) Microsoft Corporation. All rights reserved. using System; using System.ComponentModel; using MS.Internal.WindowsBase; namespace System.Windows { ////// Modes for expressions /// //CASRemoval:[StrongNameIdentityPermission(SecurityAction.LinkDemand, PublicKey = Microsoft.Internal.BuildInfo.WCP_PUBLIC_KEY_STRING)] internal enum ExpressionMode { ////// No options /// None = 0, ////// Expression may not be set in multiple places /// ////// Even if a non-shareable Expression has been attached and /// then detached, it still may not be reused /// NonSharable, ////// Expression forwards invalidations to the property on which it is set. /// ////// This option implies ForwardsInvalidations, ///as well. /// Whenever the expression is notified of an invalidation of one /// of its sources via OnPropertyInvalidation, it /// promises to invalidate the property on which it is set, so the /// property engine doesn't have to. /// /// The property engine does not /// need to keep a reference to the target /// in this case, which can allow the target to be garbage-collected /// when it is no longer in use. /// /// Expression supports DependencySources on a different Dispatcher. /// ////// This option implies SupportsUnboundSources } ///as well. /// When set, it suppresses the property engine's check that the /// DependencyObject to which the expression is attached belongs to /// the same Thread as all its DependencySources, and allows /// OnPropertyInvalidation notifications to arrive on the "wrong" /// Thread. It is the expression's responsibility to handle these /// correctly, typically by marshalling them to the right Thread. /// Note: The check is only suppressed when the source isn't owned /// by any Thread (i.e. source.Dispatcher == null). /// /// Expressions are used to define dependencies between properties /// ////// When a property's computed value is no longer considered valid, the /// property must be invalidated. The property engine propagates these /// invalidations to all dependents. //CASRemoval:[StrongNameIdentityPermission(SecurityAction.LinkDemand, PublicKey = Microsoft.Internal.BuildInfo.WCP_PUBLIC_KEY_STRING)] [TypeConverter(typeof(ExpressionConverter))] public class Expression { ////// /// An Expression can be set per-instance per-property via SetValue. /// /// Expression construction /// internal Expression() : this(ExpressionMode.None) { } ////// Expression construction /// internal Expression(ExpressionMode mode) { _flags = 0; switch(mode) { case ExpressionMode.None: break; case ExpressionMode.NonSharable: _flags |= InternalFlags.NonShareable; break; case ExpressionMode.ForwardsInvalidations: _flags |= InternalFlags.ForwardsInvalidations; _flags |= InternalFlags.NonShareable; break; case ExpressionMode.SupportsUnboundSources: _flags |= InternalFlags.ForwardsInvalidations; _flags |= InternalFlags.NonShareable; _flags |= InternalFlags.SupportsUnboundSources; break; default: throw new ArgumentException(SR.Get(SRID.UnknownExpressionMode)); } } // We need this Clone method to copy a binding during Freezable.Copy. We shouldn't be taking // the target object/dp parameters here, but Binding.ProvideValue requires it. (Binding // could probably be re-factored so that we don't need this). [FriendAccessAllowed] // Used by Freezables internal virtual Expression Copy( DependencyObject targetObject, DependencyProperty targetDP ) { // By default, just use the same copy. return this; } ////// List of sources of the Expression /// ///Sources list internal virtual DependencySource[] GetSources() { return null; } ////// Called to evaluate the Expression value /// /// DependencyObject being queried /// Property being queried ///Computed value. Unset if unavailable. internal virtual object GetValue(DependencyObject d, DependencyProperty dp) { return DependencyProperty.UnsetValue; } ////// Allows Expression to store set values /// /// DependencyObject being set /// Property being set /// Value being set ///true if Expression handled storing of the value internal virtual bool SetValue(DependencyObject d, DependencyProperty dp, object value) { return false; } ////// Notification that the Expression has been set as a property's value /// /// DependencyObject being set /// Property being set internal virtual void OnAttach(DependencyObject d, DependencyProperty dp) { } ////// Notification that the Expression has been removed as a property's value /// /// DependencyObject being cleared /// Property being cleared internal virtual void OnDetach(DependencyObject d, DependencyProperty dp) { } ////// Notification that a Dependent that this Expression established has /// been invalidated as a result of a Source invalidation /// /// DependencyObject that was invalidated /// Changed event args for the property that was invalidated internal virtual void OnPropertyInvalidation(DependencyObject d, DependencyPropertyChangedEventArgs args) { } ////// Dynamically change this Expression sources (availiable only for NonShareable /// Expressions) /// ////// Expression must be in use on provided DependencyObject/DependencyProperty. /// GetSources must reflect the old sources to be replaced by the provided newSources. /// /// DependencyObject whose sources are to be updated /// The property that the Expression is set to /// New sources internal void ChangeSources(DependencyObject d, DependencyProperty dp, DependencySource[] newSources) { if (d == null && !ForwardsInvalidations) { throw new ArgumentNullException("d"); } if (dp == null && !ForwardsInvalidations) { throw new ArgumentNullException("dp"); } if (Shareable) { throw new InvalidOperationException(SR.Get(SRID.ShareableExpressionsCannotChangeSources)); } DependencyObject.ValidateSources(d, newSources, this); // Additional validation in callee if (ForwardsInvalidations) { DependencyObject.ChangeExpressionSources(this, null, null, newSources); } else { DependencyObject.ChangeExpressionSources(this, d, dp, newSources); } } // Determines if Expression can be attached: // 1) If Shareable // 2) If NonShareable and not HasBeenAttached internal bool Attachable { // Once a NonShareable has been Attached, it can't be used anywhere // else again (even if it's been Detached) get { return Shareable || !HasBeenAttached; } } internal bool Shareable { get { return (_flags & InternalFlags.NonShareable) == 0; } } internal bool ForwardsInvalidations { get { return (_flags & InternalFlags.ForwardsInvalidations) != 0; } } internal bool SupportsUnboundSources { get { return (_flags & InternalFlags.SupportsUnboundSources) != 0; } } internal bool HasBeenAttached { get { return (_flags & InternalFlags.Attached) != 0; } } internal void MarkAttached() { _flags |= InternalFlags.Attached; } ////// Expression.GetValue can return NoValue to indicate that /// the property engine should obtain the value some other way. /// [FriendAccessAllowed] internal static readonly object NoValue = new object(); private InternalFlags _flags; [Flags] private enum InternalFlags { None = 0x0, NonShareable = 0x1, ForwardsInvalidations = 0x2, SupportsUnboundSources = 0x4, Attached = 0x8, } } } // File provided for Reference Use Only by Microsoft Corporation (c) 2007. // Copyright (c) Microsoft Corporation. All rights reserved.
Link Menu
This book is available now!
Buy at Amazon US or
Buy at Amazon UK
- BuildProvider.cs
- UIElementParagraph.cs
- User.cs
- IsolatedStorageFilePermission.cs
- BufferBuilder.cs
- Run.cs
- ArraySortHelper.cs
- DecimalConverter.cs
- Wizard.cs
- PnrpPeerResolverElement.cs
- KeyNotFoundException.cs
- ClientFormsAuthenticationCredentials.cs
- SqlServices.cs
- FileStream.cs
- ReversePositionQuery.cs
- SurrogateEncoder.cs
- PartitionerQueryOperator.cs
- ClockController.cs
- ClientRolePrincipal.cs
- QueryComponents.cs
- FormatException.cs
- CustomErrorsSectionWrapper.cs
- SmtpSection.cs
- _Semaphore.cs
- DataGridViewRowPrePaintEventArgs.cs
- XmlHierarchicalEnumerable.cs
- SqlSelectStatement.cs
- ToolStripDropDownItem.cs
- DispatcherProcessingDisabled.cs
- InfoCardBinaryReader.cs
- AbstractSvcMapFileLoader.cs
- ObjectTypeMapping.cs
- LiteralDesigner.cs
- ServiceContractListItemList.cs
- XmlDeclaration.cs
- EventListenerClientSide.cs
- RequestTimeoutManager.cs
- InternalDuplexChannelFactory.cs
- TypeDependencyAttribute.cs
- JsonDeserializer.cs
- RNGCryptoServiceProvider.cs
- SqlCacheDependencySection.cs
- BufferModesCollection.cs
- WebBrowserBase.cs
- ArrayConverter.cs
- PreparingEnlistment.cs
- WorkflowItemsPresenter.cs
- DrawingBrush.cs
- XmlSchemaSimpleTypeRestriction.cs
- SystemKeyConverter.cs
- Annotation.cs
- ApplicationHost.cs
- DataTableMapping.cs
- ContextProperty.cs
- SrgsGrammarCompiler.cs
- RefExpr.cs
- CustomTypeDescriptor.cs
- EmbeddedObject.cs
- PageWrapper.cs
- CompiledRegexRunnerFactory.cs
- InkCanvasInnerCanvas.cs
- ControlParameter.cs
- TypeAccessException.cs
- FileLevelControlBuilderAttribute.cs
- PackageDocument.cs
- ValidationSettings.cs
- VectorCollectionValueSerializer.cs
- BitmapEffectInput.cs
- HwndProxyElementProvider.cs
- TransactionFilter.cs
- ChannelSinkStacks.cs
- GPStream.cs
- TemplateEditingVerb.cs
- AudienceUriMode.cs
- XamlFxTrace.cs
- AttributeSetAction.cs
- JoinSymbol.cs
- MarshalByValueComponent.cs
- CellPartitioner.cs
- FontTypeConverter.cs
- SqlTypesSchemaImporter.cs
- SchemaImporter.cs
- StringUtil.cs
- isolationinterop.cs
- DataServiceConfiguration.cs
- InputMethodStateTypeInfo.cs
- FixedSOMTable.cs
- PermissionToken.cs
- ProvidePropertyAttribute.cs
- SrgsItemList.cs
- Transform3DGroup.cs
- CurrentChangingEventArgs.cs
- TreeNode.cs
- NodeLabelEditEvent.cs
- ThreadExceptionDialog.cs
- TextServicesDisplayAttribute.cs
- CommandBinding.cs
- RadialGradientBrush.cs
- XmlReflectionMember.cs
- TextEditorDragDrop.cs