Code:
/ Dotnetfx_Vista_SP2 / Dotnetfx_Vista_SP2 / 8.0.50727.4016 / DEVDIV / depot / DevDiv / releases / Orcas / QFE / 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
- ToolStripPanelRenderEventArgs.cs
- CodeAccessPermission.cs
- ClickablePoint.cs
- DefinitionBase.cs
- ApplicationFileCodeDomTreeGenerator.cs
- GC.cs
- EqualityComparer.cs
- EntityException.cs
- TextLineResult.cs
- ExtensionFile.cs
- DrawTreeNodeEventArgs.cs
- FollowerQueueCreator.cs
- XmlSchemaObjectCollection.cs
- BufferedGraphics.cs
- TraceInternal.cs
- QueueNameHelper.cs
- DataSourceCollectionBase.cs
- PopOutPanel.cs
- TextComposition.cs
- DropShadowEffect.cs
- IsolatedStoragePermission.cs
- AuthenticationSection.cs
- ApplicationInfo.cs
- WebServiceParameterData.cs
- CompilerState.cs
- TypeUtils.cs
- XomlSerializationHelpers.cs
- DocumentViewerBase.cs
- FreeFormDragDropManager.cs
- ZipIOCentralDirectoryFileHeader.cs
- ClassGenerator.cs
- DesigntimeLicenseContext.cs
- FixedSOMElement.cs
- ITreeGenerator.cs
- TypedTableBase.cs
- FileUpload.cs
- ResolveMatchesCD1.cs
- EncryptionUtility.cs
- PrivateUnsafeNativeCompoundFileMethods.cs
- ImageSource.cs
- ThaiBuddhistCalendar.cs
- XmlSortKey.cs
- GraphicsState.cs
- OdbcConnectionStringbuilder.cs
- WindowsStatusBar.cs
- FacetValues.cs
- TextEditorTables.cs
- DirectoryNotFoundException.cs
- TokenBasedSet.cs
- StringDictionary.cs
- SettingsPropertyNotFoundException.cs
- GeneratedView.cs
- MimeXmlImporter.cs
- ScrollChrome.cs
- DataReceivedEventArgs.cs
- EncryptedKey.cs
- CaseInsensitiveComparer.cs
- HtmlFormParameterReader.cs
- UiaCoreApi.cs
- TcpAppDomainProtocolHandler.cs
- ObjectView.cs
- TrackingServices.cs
- IdentityValidationException.cs
- QueryBranchOp.cs
- pingexception.cs
- Parsers.cs
- AutomationAttributeInfo.cs
- DataControlFieldCollection.cs
- SynchronizedDispatch.cs
- ColumnBinding.cs
- GenericAuthenticationEventArgs.cs
- LookupNode.cs
- XmlSchemaNotation.cs
- Ray3DHitTestResult.cs
- MultiPageTextView.cs
- ProtectedConfiguration.cs
- NativeRightsManagementAPIsStructures.cs
- InputLanguageManager.cs
- XamlToRtfWriter.cs
- EntityDataSourceWrapperCollection.cs
- DockingAttribute.cs
- PropertyValue.cs
- SiteMapDataSource.cs
- EntityViewGenerationConstants.cs
- WorkflowInstance.cs
- ListItemConverter.cs
- XmlSequenceWriter.cs
- MobileSysDescriptionAttribute.cs
- QilParameter.cs
- safex509handles.cs
- MissingSatelliteAssemblyException.cs
- LocalizationComments.cs
- PersonalizableTypeEntry.cs
- SatelliteContractVersionAttribute.cs
- QueryContinueDragEventArgs.cs
- RadioButtonStandardAdapter.cs
- MultiPageTextView.cs
- CollectionContainer.cs
- CroppedBitmap.cs
- DataServiceBehavior.cs