Package.CreateRelationship Método

Source:

Package.cs

Source:

Package.cs

Source:

Package.cs

Source:

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

Parámetros

Devoluciones

Relación de nivel de paquete en el elemento especificado.

Excepciones

Ejemplos

En el ejemplo siguiente se muestra cómo usar CreateRelationship para crear un elemento PackageRelationship entre y Package un elemento de documento raíz.

// 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)

Comentarios

Una relación de nivel de paquete define una asociación entre el paquete y una parte o recurso de destino asociado. Una relación de nivel de paquete puede ser una de las dos formas.

• Entre un elemento Package de destino en el paquete.
• Entre un recurso Package de destino fuera del paquete.

En una relación de paquete, el paquete se considera el "propietario" de la relación. Cuando se elimina el paquete, también se eliminan todas las relaciones que pertenecen al paquete.

CreateRelationship no cambia físicamente la parte de destino ni el recurso de ninguna manera.

El destino de una relación no puede ser otra relación.

Si targetMode se especifica como Internal, targetUri debe ser un URI relativo formado según la especificación de sintaxis genérica del identificador uniforme de recursos (URI) RFC 3986 . El URI relativo interno puede ser una ruta de acceso absoluta que comienza con un carácter de barra diagonal ("/"), como "/page1.xaml" o "/images/picture4.jpg", o una ruta de acceso relativa, como ".. /imagespicture1.jpg" que se resuelve en la raíz del paquete ("/") como URI base.

Si targetMode se especifica como External, targetUri puede ser un URI absoluto o relativo formado según la especificación de sintaxis genérica del identificador uniforme de recursos (URI) RFC 3986 . http://www.microsoft.com/page2.xml es un ejemplo de un URI absoluto que hace referencia a un recurso de destino externo "page2.xml". "images/picture1.jpg" es un ejemplo de un URI relativo que también hace referencia a un recurso de destino externo "1.jpg", pero que se resuelve en el URI del propio paquete.

relationshipType debe ser un URI formado según la especificación de sintaxis genérica del identificador uniforme de recursos (URI) rfC 3986 . En la tabla siguiente se muestran los URI de nivel relationshipType de paquete definidos por la especificación de convenciones de empaquetado abierto (OPC).

Para obtener más información sobre el empaquetado y las relaciones de paquetes, vea la sección 1.3 de la especificación de convenciones de empaquetado abierto (OPC) disponible para su descarga en https://www.ecma-international.org/publications-and-standards/standards/ecma-376/.

Consulte también

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

Source:

Package.cs

Source:

Package.cs

Source:

Package.cs

Source:

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

Parámetros

Devoluciones

Relación de nivel de paquete en el elemento especificado.

Excepciones

Ejemplos

En el ejemplo siguiente se muestra cómo usar CreateRelationship para crear un elemento PackageRelationship entre y Package un elemento de documento raíz.

// 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)

Comentarios

Una relación de nivel de paquete define una asociación entre el paquete y una parte o recurso de destino asociado. Una relación de nivel de paquete puede ser una de las dos formas.

• Entre un elemento Package de destino en el paquete.
• Entre un recurso Package de destino fuera del paquete.

En una relación de paquete, el paquete se considera el "propietario" de la relación. Cuando se elimina el paquete, también se eliminan todas las relaciones que pertenecen al paquete.

CreateRelationship no cambia físicamente la parte de destino ni el recurso de ninguna manera.

El destino de una relación no puede ser otra relación.

id debe ser un identificador XML válido. El id tipo es xsd:ID y debe seguir las convenciones de nomenclatura indicadas en la especificación esquema XML 2: Tipos de datos (vea https://www.w3.org/TR/xmlschema-2/#ID).

Si id se especifica como null un identificador único, se generará automáticamente. Un id objeto especificado por una cadena vacía no es válido.

Si targetMode se especifica como Internal, targetUri debe ser un URI relativo formado según la especificación de sintaxis genérica del identificador uniforme de recursos (URI) RFC 3986 . El URI relativo interno puede ser una ruta de acceso absoluta que comienza con un carácter de barra diagonal ("/"), como "/page1.xaml" o "/images/picture4.jpg", o una ruta de acceso relativa, como ".. /imagespicture1.jpg" que se resuelve en la raíz del paquete ("/") como URI base.

Si targetMode se especifica como External, targetUri puede ser un URI absoluto o relativo formado según la especificación de sintaxis genérica del identificador uniforme de recursos (URI) RFC 3986 . http://www.microsoft.com/page2.xml es un ejemplo de un URI absoluto que hace referencia a un recurso de destino externo "page2.xml". "images/picture1.jpg" es un ejemplo de un URI relativo que también hace referencia a un recurso de destino externo "1.jpg", pero que se resuelve en el URI del propio paquete.

relationshipType debe ser un URI formado según la especificación de sintaxis genérica del identificador uniforme de recursos (URI) rfC 3986 . En la tabla siguiente se muestran los URI de nivel relationshipType de paquete definidos por la especificación de convenciones de empaquetado abierto (OPC).

Para obtener más información sobre el empaquetado y las relaciones de paquetes, consulte la sección 1.3 de la especificación de convenciones de empaquetado abierto (OPC) disponible para su descarga en https://www.ecma-international.org/publications-and-standards/standards/ecma-376/.

Consulte también

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