Code:
/ 4.0 / 4.0 / DEVDIV_TFS / Dev10 / Releases / RTMRel / wpf / src / Framework / MS / Internal / PtsHost / PageBreakRecord.cs / 1305600 / PageBreakRecord.cs
//---------------------------------------------------------------------------- // // Copyright (C) Microsoft Corporation. All rights reserved. // // File: PageBreakRecord.cs // // Description: Break records for PTS pages. // //--------------------------------------------------------------------------- using System; // IntPtr, IDisposable, ... using System.Threading; // Interlocked using System.Security; // SecurityCritical using MS.Internal.PtsHost.UnsafeNativeMethods; // PTS namespace MS.Internal.PtsHost { ////// PageBreakRecord is used to represent a break record for top level PTS /// page. Points to break record structure of PTS page. /// internal sealed class PageBreakRecord : IDisposable { //------------------------------------------------------------------- // // Constructors // //------------------------------------------------------------------- #region Constructors ////// Constructor. /// /// Current PTS Context. /// PTS page break record. /// Page number. internal PageBreakRecord(PtsContext ptsContext, SecurityCriticalDataForSetbr, int pageNumber) { Invariant.Assert(ptsContext != null, "Invalid PtsContext object."); Invariant.Assert(br.Value != IntPtr.Zero, "Invalid break record object."); _br = br; _pageNumber = pageNumber; // In the finalizer we may need to reference an object instance // to do the right cleanup. For this reason store a WeakReference // to such object. _ptsContext = new WeakReference(ptsContext); // BreakRecord contains unmanaged resources that need to be released when // BreakRecord is destroyed or Dispatcher is closing. For this reason keep // track of this BreakRecord in PtsContext. ptsContext.OnPageBreakRecordCreated(_br); } /// /// Finalizer - releases unmanaged resources. /// ~PageBreakRecord() { Dispose(false); } #endregion Constructors //-------------------------------------------------------------------- // // Public Methods // //------------------------------------------------------------------- #region Public Methods ////// Dispose allocated resources. /// public void Dispose() { Dispose(true); GC.SuppressFinalize(this); } #endregion Public Methods //-------------------------------------------------------------------- // // Internal Properties // //-------------------------------------------------------------------- #region Internal Properties ////// PTS page break record. /// internal IntPtr BreakRecord { get { return _br.Value; } } ////// Page number of the page starting at the break position. /// internal int PageNumber { get { return _pageNumber; } } #endregion Internal Properties //------------------------------------------------------------------- // // Private Methods // //-------------------------------------------------------------------- #region Private Methods ////// Destroys all unmanaged resources. /// /// Whether dispose is caused by explicit call to Dispose. ////// Finalizer needs to follow rules below: /// a) Your Finalize method must tolerate partially constructed instances. /// b) Your Finalize method must consider the consequence of failure. /// c) Your object is callable after Finalization. /// d) Your object is callable during Finalization. /// e) Your Finalizer could be called multiple times. /// f) Your Finalizer runs in a delicate security context. /// See: http://blogs.msdn.com/[....]/archive/2004/02/20/77460.aspx /// ////// Critical, because sets SecurityCriticalDataForSet. /// Safe, because sets SecurityCriticalDataForSet to IntPtr.Zero, which is safe. /// [SecurityCritical, SecurityTreatAsSafe] private void Dispose(bool disposing) { PtsContext ptsContext = null; // Do actual dispose only once. if (Interlocked.CompareExchange(ref _disposed, 1, 0) == 0) { // Dispose PTS break record. // According to following article the entire reachable graph from // a finalizable object is promoted, and it is safe to access its // members if they do not have their own finalizers. // Hence it is OK to access _ptsContext during finalization. // See: http://blogs.msdn.com/[....]/archive/2004/02/20/77460.aspx ptsContext = _ptsContext.Target as PtsContext; if (ptsContext != null && !ptsContext.Disposed) { // Notify PtsContext that BreakRecord is not used anymore, so all // associated resources can by destroyed. ptsContext.OnPageBreakRecordDisposed(_br, disposing); } // Cleanup the state. _br.Value = IntPtr.Zero; _ptsContext = null; } } #endregion Private Methods //------------------------------------------------------------------- // // Private Fields // //------------------------------------------------------------------- #region Private Fields ////// PTS page break record. /// private SecurityCriticalDataForSet_br; /// /// Page number of the page starting at the break position. /// private readonly int _pageNumber; ////// In the finalizer we may need to reference an instance of PtsContext /// to do the right cleanup. For this reason store a WeakReference /// to it. /// private WeakReference _ptsContext; ////// Whether object is already disposed. /// private int _disposed; #endregion Private Fields } } // File provided for Reference Use Only by Microsoft Corporation (c) 2007. // Copyright (c) Microsoft Corporation. All rights reserved. //---------------------------------------------------------------------------- // // Copyright (C) Microsoft Corporation. All rights reserved. // // File: PageBreakRecord.cs // // Description: Break records for PTS pages. // //--------------------------------------------------------------------------- using System; // IntPtr, IDisposable, ... using System.Threading; // Interlocked using System.Security; // SecurityCritical using MS.Internal.PtsHost.UnsafeNativeMethods; // PTS namespace MS.Internal.PtsHost { ////// PageBreakRecord is used to represent a break record for top level PTS /// page. Points to break record structure of PTS page. /// internal sealed class PageBreakRecord : IDisposable { //------------------------------------------------------------------- // // Constructors // //------------------------------------------------------------------- #region Constructors ////// Constructor. /// /// Current PTS Context. /// PTS page break record. /// Page number. internal PageBreakRecord(PtsContext ptsContext, SecurityCriticalDataForSetbr, int pageNumber) { Invariant.Assert(ptsContext != null, "Invalid PtsContext object."); Invariant.Assert(br.Value != IntPtr.Zero, "Invalid break record object."); _br = br; _pageNumber = pageNumber; // In the finalizer we may need to reference an object instance // to do the right cleanup. For this reason store a WeakReference // to such object. _ptsContext = new WeakReference(ptsContext); // BreakRecord contains unmanaged resources that need to be released when // BreakRecord is destroyed or Dispatcher is closing. For this reason keep // track of this BreakRecord in PtsContext. ptsContext.OnPageBreakRecordCreated(_br); } /// /// Finalizer - releases unmanaged resources. /// ~PageBreakRecord() { Dispose(false); } #endregion Constructors //-------------------------------------------------------------------- // // Public Methods // //------------------------------------------------------------------- #region Public Methods ////// Dispose allocated resources. /// public void Dispose() { Dispose(true); GC.SuppressFinalize(this); } #endregion Public Methods //-------------------------------------------------------------------- // // Internal Properties // //-------------------------------------------------------------------- #region Internal Properties ////// PTS page break record. /// internal IntPtr BreakRecord { get { return _br.Value; } } ////// Page number of the page starting at the break position. /// internal int PageNumber { get { return _pageNumber; } } #endregion Internal Properties //------------------------------------------------------------------- // // Private Methods // //-------------------------------------------------------------------- #region Private Methods ////// Destroys all unmanaged resources. /// /// Whether dispose is caused by explicit call to Dispose. ////// Finalizer needs to follow rules below: /// a) Your Finalize method must tolerate partially constructed instances. /// b) Your Finalize method must consider the consequence of failure. /// c) Your object is callable after Finalization. /// d) Your object is callable during Finalization. /// e) Your Finalizer could be called multiple times. /// f) Your Finalizer runs in a delicate security context. /// See: http://blogs.msdn.com/[....]/archive/2004/02/20/77460.aspx /// ////// Critical, because sets SecurityCriticalDataForSet. /// Safe, because sets SecurityCriticalDataForSet to IntPtr.Zero, which is safe. /// [SecurityCritical, SecurityTreatAsSafe] private void Dispose(bool disposing) { PtsContext ptsContext = null; // Do actual dispose only once. if (Interlocked.CompareExchange(ref _disposed, 1, 0) == 0) { // Dispose PTS break record. // According to following article the entire reachable graph from // a finalizable object is promoted, and it is safe to access its // members if they do not have their own finalizers. // Hence it is OK to access _ptsContext during finalization. // See: http://blogs.msdn.com/[....]/archive/2004/02/20/77460.aspx ptsContext = _ptsContext.Target as PtsContext; if (ptsContext != null && !ptsContext.Disposed) { // Notify PtsContext that BreakRecord is not used anymore, so all // associated resources can by destroyed. ptsContext.OnPageBreakRecordDisposed(_br, disposing); } // Cleanup the state. _br.Value = IntPtr.Zero; _ptsContext = null; } } #endregion Private Methods //------------------------------------------------------------------- // // Private Fields // //------------------------------------------------------------------- #region Private Fields ////// PTS page break record. /// private SecurityCriticalDataForSet_br; /// /// Page number of the page starting at the break position. /// private readonly int _pageNumber; ////// In the finalizer we may need to reference an instance of PtsContext /// to do the right cleanup. For this reason store a WeakReference /// to it. /// private WeakReference _ptsContext; ////// Whether object is already disposed. /// private int _disposed; #endregion Private Fields } } // 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
- TaskFormBase.cs
- LayoutTable.cs
- LogSwitch.cs
- HostExecutionContextManager.cs
- DesignBindingPicker.cs
- _SecureChannel.cs
- CheckBoxList.cs
- VerificationException.cs
- ScriptReferenceBase.cs
- DataGridViewAutoSizeModeEventArgs.cs
- HtmlEncodedRawTextWriter.cs
- MLangCodePageEncoding.cs
- XmlElementAttribute.cs
- TimerElapsedEvenArgs.cs
- OneWayElement.cs
- WebHttpElement.cs
- Function.cs
- Configuration.cs
- NeutralResourcesLanguageAttribute.cs
- AnnotationResource.cs
- FileUpload.cs
- ReachFixedDocumentSerializer.cs
- TextTreeUndoUnit.cs
- HttpProfileBase.cs
- TextSearch.cs
- RectangleConverter.cs
- DiscoveryClientReferences.cs
- QueryPageSettingsEventArgs.cs
- MemberInitExpression.cs
- ToolStripArrowRenderEventArgs.cs
- TypeListConverter.cs
- ReflectionPermission.cs
- DurableErrorHandler.cs
- TextEffectResolver.cs
- HwndMouseInputProvider.cs
- DbConnectionClosed.cs
- PresentationSource.cs
- __ConsoleStream.cs
- DetailsViewUpdateEventArgs.cs
- NavigateUrlConverter.cs
- HtmlGenericControl.cs
- BlurEffect.cs
- ValueCollectionParameterReader.cs
- SapiRecoInterop.cs
- MaterialGroup.cs
- DesigntimeLicenseContextSerializer.cs
- MruCache.cs
- CodeAttributeArgumentCollection.cs
- MetadataArtifactLoaderResource.cs
- SamlAssertionKeyIdentifierClause.cs
- columnmapfactory.cs
- SelectionRange.cs
- LocatorPart.cs
- QualificationDataAttribute.cs
- NestedContainer.cs
- DataGridViewColumnTypeEditor.cs
- XamlGridLengthSerializer.cs
- SessionEndedEventArgs.cs
- CachedBitmap.cs
- DelegatingHeader.cs
- SerializerDescriptor.cs
- SoundPlayer.cs
- TextMetrics.cs
- SqlConnectionString.cs
- SynchronizationScope.cs
- ParagraphVisual.cs
- ModifierKeysConverter.cs
- FactoryGenerator.cs
- HitTestWithGeometryDrawingContextWalker.cs
- WebPartMenu.cs
- FixUp.cs
- DeviceOverridableAttribute.cs
- Vector3DCollectionConverter.cs
- ExpandedProjectionNode.cs
- ApplicationTrust.cs
- NamedObject.cs
- JumpItem.cs
- CompiledQueryCacheEntry.cs
- WindowsIPAddress.cs
- WorkflowDesignerColors.cs
- PolyLineSegment.cs
- CodeDomDecompiler.cs
- DeploymentSectionCache.cs
- SourceSwitch.cs
- GatewayIPAddressInformationCollection.cs
- DashStyle.cs
- ParameterModifier.cs
- DbDataAdapter.cs
- SchemaComplexType.cs
- ScrollItemPattern.cs
- DateTimeStorage.cs
- EndPoint.cs
- WindowAutomationPeer.cs
- InputEventArgs.cs
- DataStreamFromComStream.cs
- MessageRpc.cs
- TextEffectResolver.cs
- SharingService.cs
- TreeIterator.cs
- IRCollection.cs