PackagePart.CreateRelationship Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Crea una relación de nivel de elemento entre este objeto PackagePart y un objeto PackagePart de destino especificado o un recurso externo.
Sobrecargas
| CreateRelationship(Uri, TargetMode, String) |
Crea una relación de nivel de elemento entre este objeto PackagePart y un objeto PackagePart de destino especificado o un recurso externo. |
| CreateRelationship(Uri, TargetMode, String, String) |
Crea una relación de nivel de elemento entre este objeto PackagePart y un objeto PackagePart de destino especificado o un recurso externo. |
Comentarios
Una relación de nivel de parte define una asociación entre esta parte y un elemento o recurso de destino. Una relación de nivel de parte puede ser una de las dos formas.
Entre un origen PackagePart a un destino PackagePart dentro de Package.
Entre un origen PackagePart a un recurso de destino fuera del paquete.
En una relación de parte, el elemento de origen se considera el "propietario" de la relación. Cuando se elimina el elemento de origen, también se eliminan todas las relaciones que pertenecen al elemento. El proceso de creación o eliminación de la relación no modifica físicamente el elemento o recurso de destino de ninguna manera.
El CreateRelationship método no cambia físicamente la parte de origen ni la parte de destino o el recurso de ninguna manera.
El destino de una relación no puede ser otra relación.
Para obtener más información sobre 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/.
Para obtener más información sobre los documentos XPS, vea la especificación de papel Open XML (XPS) disponible para su descarga en https://www.ecma-international.org/publications-and-standards/standards/ecma-388/.
CreateRelationship(Uri, TargetMode, String)
- Source:
- PackagePart.cs
- Source:
- PackagePart.cs
- Source:
- PackagePart.cs
Crea una relación de nivel de elemento entre este objeto PackagePart y un objeto PackagePart de destino especificado o un recurso externo.
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.PackageRelationshipPublic Function CreateRelationship (targetUri As Uri, targetMode As TargetMode, relationshipType As String) As PackageRelationshipParámetros
- targetUri
- Uri
URI del elemento de destino.
- targetMode
- TargetMode
Uno de los valores de enumeración. Por ejemplo, Internal si el elemento de destino está en Package; o External si el destino es un recurso externo respecto a Package.
- relationshipType
- String
Rol de la relación.
Devoluciones
La relación de nivel de elemento entre PackagePart y PackagePart de destino o recurso externo.
Excepciones
Se ha eliminado el elemento.
o bien
La propiedad Package no está abierta (se ha llamado a Dispose(Boolean) o Close()).
targetUri o relationshipType es null.
El parámetro targetMode no es un valor válido de la enumeración TargetMode.
El elemento identificado por el targetUri es una relación (el destino de una relación no puede ser otra relación).
o bien
targetMode se especifica como Internal, pero targetUri es un URI externo absoluto.
El paquete es de sólo lectura; es decir, no se pueden agregar relaciones nuevas.
Comentarios
Una relación de nivel de parte define una asociación entre esta parte y un elemento o recurso de destino. Una relación de nivel de parte puede ser una de dos formas.
Entre un origen PackagePart a un destino PackagePart dentro de Package.
Entre un PackagePart origen a un recurso de destino fuera del paquete.
En una relación de parte, el elemento de origen se considera el "propietario" de la relación. Cuando se elimina el elemento de origen, también se eliminan todas las relaciones que pertenecen al elemento. El proceso de creación o eliminación de la relación no modifica físicamente la parte o el recurso de destino de ninguna manera.
El CreateRelationship método no cambia físicamente la parte de origen ni la parte de destino o 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 de acuerdo con 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 de acuerdo con la especificación de sintaxis genérica del identificador uniforme de recursos (URI)RFC 3986. "https://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.
relationshipTypedebe ser un URI formado según la especificación de sintaxis genérica del identificador uniforme de recursos (URI)rfC 3986. Los distintos tipos de paquete pueden definir diferentes tipos de relación de nivel de parte. En la tabla siguiente se muestran los URI de nivel de parte relationshipType definidos para los documentos que se ajustan a la especificación de papel open XML (XPS).
| Relación Part-Level de documentos XPS | URI de tipo de relación |
|---|---|
| Definiciones de firma digital | http://schemas.microsoft.com/xps/2005/06/signature-definitions |
| DiscardControl | http://schemas.microsoft.com/xps/2005/06/discard-control |
| DocumentStructure | http://schemas.microsoft.com/xps/2005/06/documentstructure |
| PrintTicket | http://schemas.microsoft.com/xps/2005/06/printticket |
| Recurso necesario | http://schemas.microsoft.com/xps/2005/06/required-resource |
| Fuente restringida | http://schemas.microsoft.com/xps/2005/06/restricted-font |
| StartPart | http://schemas.microsoft.com/xps/2005/06/fixedrepresentation |
| StoryFragments | http://schemas.microsoft.com/xps/2005/06/storyfragments |
Para obtener más información sobre 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/.
Para obtener más información sobre los documentos XPS, vea la especificación de papel Open XML (XPS) disponible para su descarga en https://www.ecma-international.org/publications-and-standards/standards/ecma-388/.
Consulte también
- CreateRelationship
- DeleteRelationship(String)
- GetRelationship(String)
- GetRelationships()
- GetRelationshipsByType(String)
- Especificación de convenciones de empaquetado abierto
Se aplica a
CreateRelationship(Uri, TargetMode, String, String)
- Source:
- PackagePart.cs
- Source:
- PackagePart.cs
- Source:
- PackagePart.cs
Crea una relación de nivel de elemento entre este objeto PackagePart y un objeto PackagePart de destino especificado o un recurso externo.
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.PackageRelationshipPublic Function CreateRelationship (targetUri As Uri, targetMode As TargetMode, relationshipType As String, id As String) As PackageRelationshipParámetros
- targetUri
- Uri
URI del elemento de destino.
- targetMode
- TargetMode
Uno de los valores de enumeración. Por ejemplo, Internal si el elemento de destino está en Package; o External si el destino es un recurso externo respecto a Package.
- relationshipType
- String
Rol de la relación.
- id
- String
Identificador único de la relación.
Devoluciones
La relación de nivel de elemento entre PackagePart y PackagePart de destino o recurso externo.
Excepciones
Se ha eliminado el elemento.
o bien
La propiedad Package no está abierta (se ha llamado a Dispose(Boolean) o Close()).
targetUri o relationshipType es null.
El parámetro targetMode no es un valor válido de la enumeración TargetMode.
El elemento identificado por el targetUri es una relación (el destino de una relación no puede ser otra relación).
o bien
targetMode se especifica como Internal, pero targetUri es un URI externo absoluto.
El paquete es de sólo lectura; es decir, no se pueden agregar relaciones nuevas.
id no es un identificador XML válido.
o bien
Ya existe un elemento con el id especificado.
Comentarios
Una relación de nivel de parte define una asociación entre esta parte y un elemento o recurso de destino. Una relación de nivel de parte puede ser una de dos formas.
Entre un origen PackagePart a un destino PackagePart dentro de Package.
Entre un PackagePart origen a un recurso de destino fuera del paquete.
En una relación de parte, el elemento de origen se considera el "propietario" de la relación. Cuando se elimina el elemento de origen, también se eliminan todas las relaciones que pertenecen al elemento. El proceso de creación o eliminación de la relación no modifica físicamente la parte o el recurso de destino de ninguna manera.
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).
El CreateRelationship método no cambia físicamente la parte de origen ni la parte de destino o 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 de acuerdo con 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 de acuerdo con la especificación de sintaxis genérica del identificador uniforme de recursos (URI)RFC 3986. "https://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.
relationshipTypedebe ser un URI formado según la especificación de sintaxis genérica del identificador uniforme de recursos (URI)rfC 3986. Los distintos tipos de paquete pueden definir diferentes tipos de relación de nivel de parte. En la tabla siguiente se muestran los URI de nivel de parte relationshipType definidos para los documentos que se ajustan a la especificación de papel open XML (XPS).
| Relación Part-Level de documentos XPS | URI de tipo de relación |
|---|---|
| Definiciones de firma digital | http://schemas.microsoft.com/xps/2005/06/signature-definitions |
| DiscardControl | http://schemas.microsoft.com/xps/2005/06/discard-control |
| DocumentStructure | http://schemas.microsoft.com/xps/2005/06/documentstructure |
| PrintTicket | http://schemas.microsoft.com/xps/2005/06/printticket |
| Recurso necesario | http://schemas.microsoft.com/xps/2005/06/required-resource |
| Fuente restringida | http://schemas.microsoft.com/xps/2005/06/restricted-font |
| StartPart | http://schemas.microsoft.com/xps/2005/06/fixedrepresentation |
| StoryFragments | http://schemas.microsoft.com/xps/2005/06/storyfragments |
Para obtener más información sobre 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/.
Para obtener más información sobre los documentos XPS, consulte la especificación de papel Open XML (XPS) disponible para su descarga en https://www.ecma-international.org/publications-and-standards/standards/ecma-388/.
Consulte también
- CreateRelationship
- DeleteRelationship(String)
- GetRelationship(String)
- GetRelationships()
- GetRelationshipsByType(String)
- Especificación de convenciones de empaquetado abierto
Se aplica a
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de