Code:
/ Net / Net / 3.5.50727.3053 / DEVDIV / depot / DevDiv / releases / Orcas / SP / wpf / src / Base / System / IO / Packaging / PackageRelationship.cs / 1 / PackageRelationship.cs
//------------------------------------------------------------------------------
//
//
// Copyright (C) Microsoft Corporation. All rights reserved.
//
//
// Description:
// This is a class for representing a PackageRelationship. This is a part of the
// MMCF Packaging Layer.
//
// History:
// 01/03/2004: SarjanaS: Initial creation.
// 03/17/2004: BruceMac: Initial implementation or PackageRelationship methods
//
//-----------------------------------------------------------------------------
using System;
using System.Collections;
using System.Xml;
using System.Windows; // For Exception strings - SRID
using System.Text; // for StringBuilder
using System.Diagnostics; // for Debug.Assert
using MS.Internal; // for Invariant.Assert
namespace System.IO.Packaging
{
///
/// This class is used to express a relationship between a source and a target part.
/// The only way to create a PackageRelationship, is to call the PackagePart.CreateRelationship()
/// or Package.CreateRelationship(). A relationship is owned by a part or by the package itself.
/// If the source part is deleted all the relationships it owns are also deleted.
/// A target of the relationship need not be present.
public class PackageRelationship
{
//-----------------------------------------------------
//
// Public Constructors
//
//-----------------------------------------------------
// None
//------------------------------------------------------
//
// Public Properties
//
//-----------------------------------------------------
#region Public Properties
///
/// This is a reference to the parent PackagePart to which this relationship belongs.
///
/// Uri
public Uri SourceUri
{
get
{
if (_source == null)
return PackUriHelper.PackageRootUri;
else
return _source.Uri;
}
}
///
/// Uri of the TargetPart, that this relationship points to.
///
///
/// Type of the relationship - used to uniquely define the role of the relationship
///
///
/// Enumeration value indicating the interpretations of the "base" of the target uri.
///
///
/// PackageRelationship's identifier. Unique across relationships for the given source.
///
/// String
public String Id
{
get
{
return _id;
}
}
///
/// PackageRelationship's owning Package object.
///
/// Package
public Package Package
{
get
{
return _package;
}
}
#endregion Public Properties
//------------------------------------------------------
//
// Public Methods
//
//------------------------------------------------------
// None
//-----------------------------------------------------
//
// Public Events
//
//------------------------------------------------------
// None
//-----------------------------------------------------
//
// Internal Constructors
//
//-----------------------------------------------------
#region Internal Constructor
///
/// PackageRelationship constructor
///
/// Owning Package object for this relationship
/// owning part - will be null if the owner is the container
/// target of relationship
/// enum specifying the interpretation of the base uri for the target uri
/// type name
/// unique identifier
internal PackageRelationship(Package package, PackagePart sourcePart, Uri targetUri, TargetMode targetMode, string relationshipType, string id)
{
//sourcePart can be null to represent that the relationships are at the package level
if (package == null)
throw new ArgumentNullException("package");
if (targetUri == null)
throw new ArgumentNullException("targetUri");
if (relationshipType == null)
throw new ArgumentNullException("relationshipType");
if (id == null)
throw new ArgumentNullException("id");
// The ID is guaranteed to be an XML ID by the caller (InternalRelationshipCollection).
// The following check is a precaution against future bug introductions.
#if DEBUG
try
{
// An XSD ID is an NCName that is unique. We can't check uniqueness at this level.
XmlConvert.VerifyNCName(id);
}
catch(XmlException exception)
{
throw new XmlException(SR.Get(SRID.NotAValidXmlIdString, id), exception);
}
#endif
// Additional check - don't accept absolute Uri's if targetMode is Internal.
Debug.Assert((targetMode == TargetMode.External || !targetUri.IsAbsoluteUri),
"PackageRelationship target must be relative if the TargetMode is Internal");
// Additional check - Verify if the Enum value is valid
Debug.Assert ((targetMode >= TargetMode.Internal || targetMode <= TargetMode.External),
"TargetMode enum value is out of Range");
// Look for empty string or string with just spaces
Debug.Assert(relationshipType.Trim() != String.Empty,
"RelationshipType cannot be empty string or a string with just spaces");
_package = package;
_source = sourcePart;
_targetUri = targetUri;
_relationshipType = relationshipType;
_targetMode = targetMode;
_id = id;
}
#endregion Internal Constructor
//-----------------------------------------------------
//
// Internal Properties
//
//------------------------------------------------------
#region Internal Properties
internal static Uri ContainerRelationshipPartName
{
get
{
return _containerRelationshipPartName;
}
}
// Property used in streaming production to be able to keep the set
// of all properties that have been created in memory while knowing
// which remain to be written to XML.
internal bool Saved
{
get
{
return _saved;
}
set
{
_saved = value;
}
}
#endregion Internal Properties
//-----------------------------------------------------
//
// Internal Methods
//
//------------------------------------------------------
// None
//------------------------------------------------------
//
// Internal Events
//
//-----------------------------------------------------
// None
//------------------------------------------------------
//
// Private Methods
//
//-----------------------------------------------------
// None
//-----------------------------------------------------
//
// Private Fields
//
//-----------------------------------------------------
#region Private Members
private Package _package;
private PackagePart _source;
private Uri _targetUri;
private string _relationshipType;
private TargetMode _targetMode;
private String _id;
private bool _saved = false;
private static readonly Uri _containerRelationshipPartName = PackUriHelper.CreatePartUri(new Uri("/_rels/.rels", UriKind.Relative));
#endregion Private Members
}
}
// 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.
//
//
// Description:
// This is a class for representing a PackageRelationship. This is a part of the
// MMCF Packaging Layer.
//
// History:
// 01/03/2004: SarjanaS: Initial creation.
// 03/17/2004: BruceMac: Initial implementation or PackageRelationship methods
//
//-----------------------------------------------------------------------------
using System;
using System.Collections;
using System.Xml;
using System.Windows; // For Exception strings - SRID
using System.Text; // for StringBuilder
using System.Diagnostics; // for Debug.Assert
using MS.Internal; // for Invariant.Assert
namespace System.IO.Packaging
{
///
/// This class is used to express a relationship between a source and a target part.
/// The only way to create a PackageRelationship, is to call the PackagePart.CreateRelationship()
/// or Package.CreateRelationship(). A relationship is owned by a part or by the package itself.
/// If the source part is deleted all the relationships it owns are also deleted.
/// A target of the relationship need not be present.
public class PackageRelationship
{
//-----------------------------------------------------
//
// Public Constructors
//
//-----------------------------------------------------
// None
//------------------------------------------------------
//
// Public Properties
//
//-----------------------------------------------------
#region Public Properties
///
/// This is a reference to the parent PackagePart to which this relationship belongs.
///
/// Uri
public Uri SourceUri
{
get
{
if (_source == null)
return PackUriHelper.PackageRootUri;
else
return _source.Uri;
}
}
///
/// Uri of the TargetPart, that this relationship points to.
///
///
/// Type of the relationship - used to uniquely define the role of the relationship
///
///
/// Enumeration value indicating the interpretations of the "base" of the target uri.
///
///
/// PackageRelationship's identifier. Unique across relationships for the given source.
///
/// String
public String Id
{
get
{
return _id;
}
}
///
/// PackageRelationship's owning Package object.
///
/// Package
public Package Package
{
get
{
return _package;
}
}
#endregion Public Properties
//------------------------------------------------------
//
// Public Methods
//
//------------------------------------------------------
// None
//-----------------------------------------------------
//
// Public Events
//
//------------------------------------------------------
// None
//-----------------------------------------------------
//
// Internal Constructors
//
//-----------------------------------------------------
#region Internal Constructor
///
/// PackageRelationship constructor
///
/// Owning Package object for this relationship
/// owning part - will be null if the owner is the container
/// target of relationship
/// enum specifying the interpretation of the base uri for the target uri
/// type name
/// unique identifier
internal PackageRelationship(Package package, PackagePart sourcePart, Uri targetUri, TargetMode targetMode, string relationshipType, string id)
{
//sourcePart can be null to represent that the relationships are at the package level
if (package == null)
throw new ArgumentNullException("package");
if (targetUri == null)
throw new ArgumentNullException("targetUri");
if (relationshipType == null)
throw new ArgumentNullException("relationshipType");
if (id == null)
throw new ArgumentNullException("id");
// The ID is guaranteed to be an XML ID by the caller (InternalRelationshipCollection).
// The following check is a precaution against future bug introductions.
#if DEBUG
try
{
// An XSD ID is an NCName that is unique. We can't check uniqueness at this level.
XmlConvert.VerifyNCName(id);
}
catch(XmlException exception)
{
throw new XmlException(SR.Get(SRID.NotAValidXmlIdString, id), exception);
}
#endif
// Additional check - don't accept absolute Uri's if targetMode is Internal.
Debug.Assert((targetMode == TargetMode.External || !targetUri.IsAbsoluteUri),
"PackageRelationship target must be relative if the TargetMode is Internal");
// Additional check - Verify if the Enum value is valid
Debug.Assert ((targetMode >= TargetMode.Internal || targetMode <= TargetMode.External),
"TargetMode enum value is out of Range");
// Look for empty string or string with just spaces
Debug.Assert(relationshipType.Trim() != String.Empty,
"RelationshipType cannot be empty string or a string with just spaces");
_package = package;
_source = sourcePart;
_targetUri = targetUri;
_relationshipType = relationshipType;
_targetMode = targetMode;
_id = id;
}
#endregion Internal Constructor
//-----------------------------------------------------
//
// Internal Properties
//
//------------------------------------------------------
#region Internal Properties
internal static Uri ContainerRelationshipPartName
{
get
{
return _containerRelationshipPartName;
}
}
// Property used in streaming production to be able to keep the set
// of all properties that have been created in memory while knowing
// which remain to be written to XML.
internal bool Saved
{
get
{
return _saved;
}
set
{
_saved = value;
}
}
#endregion Internal Properties
//-----------------------------------------------------
//
// Internal Methods
//
//------------------------------------------------------
// None
//------------------------------------------------------
//
// Internal Events
//
//-----------------------------------------------------
// None
//------------------------------------------------------
//
// Private Methods
//
//-----------------------------------------------------
// None
//-----------------------------------------------------
//
// Private Fields
//
//-----------------------------------------------------
#region Private Members
private Package _package;
private PackagePart _source;
private Uri _targetUri;
private string _relationshipType;
private TargetMode _targetMode;
private String _id;
private bool _saved = false;
private static readonly Uri _containerRelationshipPartName = PackUriHelper.CreatePartUri(new Uri("/_rels/.rels", UriKind.Relative));
#endregion Private Members
}
}
// 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
- TraceRecord.cs
- LinkTarget.cs
- CodeTypeConstructor.cs
- DataGridViewImageColumn.cs
- DataGridColumn.cs
- HttpListenerRequest.cs
- FloaterParaClient.cs
- _HelperAsyncResults.cs
- LookupTables.cs
- SafeRegistryKey.cs
- BinaryFormatterSinks.cs
- Privilege.cs
- RadioButton.cs
- DesignerImageAdapter.cs
- PackUriHelper.cs
- QilCloneVisitor.cs
- PublisherMembershipCondition.cs
- ToolStripMenuItem.cs
- AssemblyResolver.cs
- ExtendedPropertyCollection.cs
- VisualStateGroup.cs
- MultilineStringConverter.cs
- GridView.cs
- Animatable.cs
- Throw.cs
- Timer.cs
- SearchForVirtualItemEventArgs.cs
- WindowsSysHeader.cs
- BaseParagraph.cs
- PhysicalFontFamily.cs
- SpeechSynthesizer.cs
- Environment.cs
- XmlJsonWriter.cs
- DoubleLinkListEnumerator.cs
- RowSpanVector.cs
- RegexReplacement.cs
- DmlSqlGenerator.cs
- EventMap.cs
- ProcessDesigner.cs
- basecomparevalidator.cs
- SplashScreen.cs
- LocalizableAttribute.cs
- HttpRuntimeSection.cs
- FrameworkObject.cs
- DataBindingList.cs
- ColumnHeader.cs
- ClipboardProcessor.cs
- _HTTPDateParse.cs
- TextEditorSpelling.cs
- CheckBox.cs
- ListChunk.cs
- DebuggerService.cs
- ZipIOLocalFileBlock.cs
- GridViewCommandEventArgs.cs
- ThreadStartException.cs
- PropertyKey.cs
- ErrorsHelper.cs
- ViewEvent.cs
- SecurityKeyIdentifier.cs
- RowType.cs
- HtmlControlPersistable.cs
- MenuCommands.cs
- Expressions.cs
- CustomValidator.cs
- CatalogZoneAutoFormat.cs
- AssemblyHash.cs
- RoleGroupCollection.cs
- SiteOfOriginContainer.cs
- TemplateParser.cs
- ListViewHitTestInfo.cs
- columnmapfactory.cs
- XmlDocumentSchema.cs
- ServicePointManager.cs
- HttpCachePolicyBase.cs
- QuaternionRotation3D.cs
- DataGridViewSelectedColumnCollection.cs
- GPRECT.cs
- ControlPaint.cs
- HwndHost.cs
- DropShadowEffect.cs
- ExpressionBuilderCollection.cs
- CapabilitiesPattern.cs
- XmlCountingReader.cs
- BroadcastEventHelper.cs
- HwndMouseInputProvider.cs
- Stopwatch.cs
- TextViewBase.cs
- MaskedTextProvider.cs
- LifetimeServices.cs
- WorkflowTerminatedException.cs
- UDPClient.cs
- ClientSettings.cs
- DataGridViewSelectedCellsAccessibleObject.cs
- SqlRowUpdatedEvent.cs
- GroupBox.cs
- ArgumentOutOfRangeException.cs
- NativeActivityContext.cs
- NonClientArea.cs
- ValueType.cs
- XmlDesigner.cs