Package.CreateRelationship Метод

Исходный код:

Package.cs

Исходный код:

Package.cs

Исходный код:

Package.cs

Исходный код:

Package.cs

public:
 System::IO::Packaging::PackageRelationship ^ CreateRelationship(Uri ^ targetUri, System::IO::Packaging::TargetMode targetMode, System::String ^ relationshipType);

public System.IO.Packaging.PackageRelationship CreateRelationship (Uri targetUri, System.IO.Packaging.TargetMode targetMode, string relationshipType);

member this.CreateRelationship : Uri * System.IO.Packaging.TargetMode * string -> System.IO.Packaging.PackageRelationship

Public Function CreateRelationship (targetUri As Uri, targetMode As TargetMode, relationshipType As String) As PackageRelationship

Параметры

Возвращаемое значение

Связь с указанной частью на уровне пакета.

Исключения

Примеры

В следующем примере показано, как использовать CreateRelationship для создания PackageRelationship между Package и корневой частью документа.

// Add the Document part to the Package
PackagePart packagePartDocument =
    package.CreatePart(partUriDocument,
                   System.Net.Mime.MediaTypeNames.Text.Xml);

// Copy the data to the Document Part
using (FileStream fileStream = new FileStream(
       documentPath, FileMode.Open, FileAccess.Read))
{
    CopyStream(fileStream, packagePartDocument.GetStream());
}// end:using(fileStream) - Close and dispose fileStream.

// Add a Package Relationship to the Document Part
package.CreateRelationship(packagePartDocument.Uri,
                           TargetMode.Internal,
                           PackageRelationshipType);

' Add the Document part to the Package
Dim packagePartDocument As PackagePart = package.CreatePart(partUriDocument, System.Net.Mime.MediaTypeNames.Text.Xml)

' Copy the data to the Document Part
Using fileStream As New FileStream(documentPath, FileMode.Open, FileAccess.Read)
    CopyStream(fileStream, packagePartDocument.GetStream())
End Using ' end:using(fileStream) - Close and dispose fileStream.

' Add a Package Relationship to the Document Part
package.CreateRelationship(packagePartDocument.Uri, TargetMode.Internal, PackageRelationshipType)

Комментарии

Связь на уровне пакета определяет связь между пакетом и связанной целевой частью или ресурсом. Связь на уровне пакета может быть одной из двух форм.

• Между элементом и Package целевой частью в пакете.
• Между ресурсом Package и целевым ресурсом за пределами пакета.

В связи "пакет-пакет" считается "владельцем" связи. При удалении пакета также удаляются все связи, принадлежащие пакету.

CreateRelationship физически не изменяет целевую часть или ресурс каким-либо образом.

Целью связи не может быть другое отношение.

Если targetMode задано значение Internal, targetUri должен быть относительным URI, сформированным в соответствии со спецификацией универсального синтаксиса RFC 3986 . Внутренний относительный URI может быть либо абсолютным путем, начинающимся с символа косой черты ("/"), например "/page1.xaml" или "/images/picture4.jpg", либо относительным путем, таким как ". /imagespicture1.jpg", который разрешается в корневой каталог пакета ("/") в качестве базового URI.

Если targetMode задано значение External, targetUri может быть абсолютным или относительным URI, сформированным в соответствии со спецификацией универсального синтаксиса RFC 3986 . http://www.microsoft.com/page2.xml — это пример абсолютного URI, который ссылается на внешний целевой ресурс "page2.xml". "images/picture1.jpg" — это пример относительного URI, который также ссылается на внешний целевой ресурс "1.jpg", но который разрешается в URI самого пакета.

relationshipType должен быть универсальным кодом ресурса (URI), сформированным в соответствии со спецификацией универсального синтаксиса RFC 3986 . В следующей таблице показаны URI уровня relationshipType пакета, определенные спецификацией Open Packaging Conventions (OPC).

Дополнительные сведения об упаковке и связях пакетов см. в разделе 1.3 спецификации Open Packaging Conventions (OPC), доступной для скачивания по адресу https://www.ecma-international.org/publications-and-standards/standards/ecma-376/.

См. также раздел

• DeleteRelationship(String)
• GetRelationship(String)
• GetRelationships()
• GetRelationshipsByType(String)
• RelationshipExists(String)

Исходный код:

Package.cs

Исходный код:

Package.cs

Исходный код:

Package.cs

Исходный код:

Package.cs

public:
 System::IO::Packaging::PackageRelationship ^ CreateRelationship(Uri ^ targetUri, System::IO::Packaging::TargetMode targetMode, System::String ^ relationshipType, System::String ^ id);

public System.IO.Packaging.PackageRelationship CreateRelationship (Uri targetUri, System.IO.Packaging.TargetMode targetMode, string relationshipType, string? id);

public System.IO.Packaging.PackageRelationship CreateRelationship (Uri targetUri, System.IO.Packaging.TargetMode targetMode, string relationshipType, string id);

member this.CreateRelationship : Uri * System.IO.Packaging.TargetMode * string * string -> System.IO.Packaging.PackageRelationship

Public Function CreateRelationship (targetUri As Uri, targetMode As TargetMode, relationshipType As String, id As String) As PackageRelationship

Параметры

Возвращаемое значение

Связь с указанной частью на уровне пакета.

Исключения

Примеры

В следующем примере показано, как использовать CreateRelationship для создания PackageRelationship между Package и корневой частью документа.

// Add the Document part to the Package
PackagePart packagePartDocument =
    package.CreatePart(partUriDocument,
                   System.Net.Mime.MediaTypeNames.Text.Xml);

// Copy the data to the Document Part
using (FileStream fileStream = new FileStream(
       documentPath, FileMode.Open, FileAccess.Read))
{
    CopyStream(fileStream, packagePartDocument.GetStream());
}// end:using(fileStream) - Close and dispose fileStream.

// Add a Package Relationship to the Document Part
package.CreateRelationship(packagePartDocument.Uri,
                           TargetMode.Internal,
                           PackageRelationshipType);

' Add the Document part to the Package
Dim packagePartDocument As PackagePart = package.CreatePart(partUriDocument, System.Net.Mime.MediaTypeNames.Text.Xml)

' Copy the data to the Document Part
Using fileStream As New FileStream(documentPath, FileMode.Open, FileAccess.Read)
    CopyStream(fileStream, packagePartDocument.GetStream())
End Using ' end:using(fileStream) - Close and dispose fileStream.

' Add a Package Relationship to the Document Part
package.CreateRelationship(packagePartDocument.Uri, TargetMode.Internal, PackageRelationshipType)

Комментарии

Связь на уровне пакета определяет связь между пакетом и связанной целевой частью или ресурсом. Связь на уровне пакета может быть одной из двух форм.

• Между элементом и Package целевой частью в пакете.
• Между ресурсом Package и целевым ресурсом за пределами пакета.

В связи "пакет-пакет" считается "владельцем" связи. При удалении пакета также удаляются все связи, принадлежащие пакету.

CreateRelationship физически не изменяет целевую часть или ресурс каким-либо образом.

Целью связи не может быть другое отношение.

id должен быть допустимым xml-идентификатором. Тип id имеет тип xsd:ID и должен соответствовать соглашениям об именовании, предписанным в спецификации XML Schema Part 2: Datatypes (см https://www.w3.org/TR/xmlschema-2/#ID. ).

Если id параметр указан в качестве null уникального идентификатора, будет создан автоматически. Объект , id заданный пустой строкой, недопустим.

Если targetMode задано значение Internal, targetUri должен быть относительным URI, сформированным в соответствии со спецификацией универсального синтаксиса RFC 3986 . Внутренний относительный URI может быть либо абсолютным путем, начинающимся с символа косой черты ("/"), например "/page1.xaml" или "/images/picture4.jpg", либо относительным путем, таким как ". /imagespicture1.jpg", который разрешается в корневой каталог пакета ("/") в качестве базового URI.

Если targetMode задано значение External, targetUri может быть абсолютным или относительным URI, сформированным в соответствии со спецификацией универсального синтаксиса RFC 3986 . http://www.microsoft.com/page2.xml — это пример абсолютного URI, который ссылается на внешний целевой ресурс "page2.xml". "images/picture1.jpg" — это пример относительного URI, который также ссылается на внешний целевой ресурс "1.jpg", но который разрешается в URI самого пакета.

relationshipType должен быть универсальным кодом ресурса (URI), сформированным в соответствии со спецификацией универсального синтаксиса RFC 3986 . В следующей таблице показаны URI уровня relationshipType пакета, определенные спецификацией Open Packaging Conventions (OPC).

Дополнительные сведения об упаковке и связях пакетов см. в разделе 1.3 спецификации Open Packaging Conventions (OPC), доступной для скачивания по адресу https://www.ecma-international.org/publications-and-standards/standards/ecma-376/.

См. также раздел

• CreateRelationship(Uri, TargetMode, String)
• DeleteRelationship(String)
• GetRelationship(String)
• GetRelationships()
• GetRelationshipsByType(String)
• RelationshipExists(String)