Udostępnij za pośrednictwem


PackagePart.CreateRelationship Metoda

Definicja

Tworzy relację na poziomie części między tym PackagePart z określonym PackagePart docelowym lub zasobem zewnętrznym.

Przeciążenia

CreateRelationship(Uri, TargetMode, String)

Tworzy relację na poziomie części między tym PackagePart z określonym PackagePart docelowym lub zasobem zewnętrznym.

CreateRelationship(Uri, TargetMode, String, String)

Tworzy relację na poziomie części między tym PackagePart z określonym PackagePart docelowym lub zasobem zewnętrznym.

Uwagi

Relacja na poziomie części definiuje skojarzenie między tą częścią a częścią docelową lub zasobem. Relacja na poziomie części może być jedną z dwóch form.

W ramach relacji część źródłowa jest traktowana jako "właściciel" relacji. Po usunięciu części źródłowej wszystkie relacje należące do tej części również zostaną usunięte. Proces tworzenia lub usuwania relacji nie zmienia fizycznie części docelowej ani zasobu w żaden sposób.

Metoda CreateRelationship nie zmienia fizycznie części źródłowej ani części docelowej lub zasobu w żaden sposób.

Celem relacji nie może być inna relacja.

Aby uzyskać więcej informacji na temat relacji pakietów, zobacz sekcję 1.3 specyfikacji Open Packaging Conventions (OPC) specyfikacji dostępnej do pobrania na stronie https://www.ecma-international.org/publications-and-standards/standards/ecma-376/.

Aby uzyskać więcej informacji na temat dokumentów XPS, zobacz specyfikację dokumentów OPEN XML (XPS) dostępną do pobrania na https://www.ecma-international.org/publications-and-standards/standards/ecma-388/.

CreateRelationship(Uri, TargetMode, String)

Źródło:
PackagePart.cs
Źródło:
PackagePart.cs
Źródło:
PackagePart.cs
Źródło:
PackagePart.cs

Tworzy relację na poziomie części między tym PackagePart z określonym PackagePart docelowym lub zasobem zewnętrznym.

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

Parametry

targetUri
Uri

Identyfikator URI części docelowej.

targetMode
TargetMode

Jedna z wartości wyliczenia. Na przykład Internal, jeśli część docelowa znajduje się wewnątrz Package; lub External, jeśli element docelowy jest zasobem spoza Package.

relationshipType
String

Rola relacji.

Zwraca

Relacja na poziomie części między tym PackagePart z docelowym PackagePart lub zasobem zewnętrznym.

Wyjątki

Część została usunięta.

-lub-

Package nie jest otwarty (wywoływanoDispose(Boolean) lub Close()).

targetUri lub relationshipType jest null.

Parametr targetMode nie jest prawidłową wartością wyliczenia TargetMode.

Część zidentyfikowana przez targetUri jest relacją (element docelowy relacji nie może być inną relacją).

-lub-

targetMode jest określony jako Internal, ale targetUri jest bezwzględnym zewnętrznym identyfikatorem URI.

Pakiet jest tylko do odczytu (nie można dodać nowej relacji).

Uwagi

Relacja na poziomie części definiuje skojarzenie między tą częścią a częścią docelową lub zasobem. Relacja na poziomie części może być jedną z dwóch form.

W ramach relacji część źródłowa jest traktowana jako "właściciel" relacji. Po usunięciu części źródłowej wszystkie relacje należące do tej części również zostaną usunięte. Proces tworzenia lub usuwania relacji nie zmienia fizycznie części docelowej ani zasobu w żaden sposób.

Metoda CreateRelationship nie zmienia fizycznie części źródłowej ani części docelowej lub zasobu w żaden sposób.

Celem relacji nie może być inna relacja.

Jeśli jest określony jako , musi być względnym identyfikatorem URI utworzonym zgodnie ze specyfikacją składni ogólnej RFC 3986Uniform Resource Identifier (URI). Wewnętrzny względny identyfikator URI może być ścieżką bezwzględną rozpoczynającą się od znaku ukośnika ("/"), takiego jak "/page1.xaml" lub "/images/picture4.jpg", albo ścieżki względnej, takiej jak ".. /imagespicture1.jpg", który rozpoznaje element główny pakietu ("/") jako podstawowy identyfikator URI.

Jeśli jest określona jako , może być bezwzględnym lub względnym identyfikatorem URI utworzonym zgodnie ze specyfikacją składni ogólnej RFC 3986Uniform Resource Identifier (URI). "https://www.microsoft.com/page2.xml" jest przykładem bezwzględnego identyfikatora URI, który odwołuje się do zewnętrznego zasobu docelowego "page2.xml". "images/picture1.jpg" to przykład względnego identyfikatora URI, który odwołuje się również do zewnętrznego zasobu docelowego "1.jpg", ale który rozpoznaje identyfikator URI samego pakietu.

musi być identyfikatorem URI utworzonym zgodnie z specyfikacją składni ogólnej RFC 3986Uniform Resource Identifier (URI). Różne typy pakietów mogą definiować różne typy relacji na poziomie części. W poniższej tabeli przedstawiono identyfikatory URI na poziomie części zdefiniowane dla dokumentów zgodnych zspecyfikacji open XML Paper Specification (XPS).

Relacja Part-Level dokumentu XPS Identyfikator URI typu relacji
Definicje podpisów cyfrowych http://schemas.microsoft.com/xps/2005/06/signature-definitions
Odrzućcontrol 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
Wymagany zasób http://schemas.microsoft.com/xps/2005/06/required-resource
Czcionka z ograniczeniami 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

Aby uzyskać więcej informacji na temat relacji pakietów, zobacz sekcję 1.3 specyfikacji Open Packaging Conventions (OPC) specyfikacji dostępnej do pobrania na stronie https://www.ecma-international.org/publications-and-standards/standards/ecma-376/.

Aby uzyskać więcej informacji na temat dokumentów XPS, zobacz Specyfikacji papieru OPEN XML (XPS) dostępne do pobrania na .

Zobacz też

Dotyczy

CreateRelationship(Uri, TargetMode, String, String)

Źródło:
PackagePart.cs
Źródło:
PackagePart.cs
Źródło:
PackagePart.cs
Źródło:
PackagePart.cs

Tworzy relację na poziomie części między tym PackagePart z określonym PackagePart docelowym lub zasobem zewnętrznym.

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

Parametry

targetUri
Uri

Identyfikator URI części docelowej.

targetMode
TargetMode

Jedna z wartości wyliczenia. Na przykład Internal, jeśli część docelowa znajduje się wewnątrz Package; lub External, jeśli element docelowy jest zasobem spoza Package.

relationshipType
String

Rola relacji.

id
String

Unikatowy identyfikator relacji.

Zwraca

Relacja na poziomie części między tym PackagePart z docelowym PackagePart lub zasobem zewnętrznym.

Wyjątki

Część została usunięta.

-lub-

Package nie jest otwarty (wywoływanoDispose(Boolean) lub Close()).

targetUri lub relationshipType jest null.

Parametr targetMode nie jest prawidłową wartością wyliczenia TargetMode.

Część zidentyfikowana przez targetUri jest relacją (element docelowy relacji nie może być inną relacją).

-lub-

targetMode jest określony jako Internal, ale targetUri jest bezwzględnym zewnętrznym identyfikatorem URI.

Pakiet jest tylko do odczytu (nie można dodać nowej relacji).

id nie jest prawidłowym identyfikatorem XML.

-lub-

Część z określonym id już istnieje.

Uwagi

Relacja na poziomie części definiuje skojarzenie między tą częścią a częścią docelową lub zasobem. Relacja na poziomie części może być jedną z dwóch form.

W ramach relacji część źródłowa jest traktowana jako "właściciel" relacji. Po usunięciu części źródłowej wszystkie relacje należące do tej części również zostaną usunięte. Proces tworzenia lub usuwania relacji nie zmienia fizycznie części docelowej ani zasobu w żaden sposób.

id musi być prawidłowym identyfikatorem XML. Typ id to xsd:ID i musi przestrzegać konwencji nazewnictwa określonych w XML Schema Part 2: Datatypes specification (zobacz https://www.w3.org/TR/xmlschema-2/#ID).

Metoda CreateRelationship nie zmienia fizycznie części źródłowej ani części docelowej lub zasobu w żaden sposób.

Celem relacji nie może być inna relacja.

Jeśli jest określony jako , musi być względnym identyfikatorem URI utworzonym zgodnie ze specyfikacją składni ogólnej RFC 3986Uniform Resource Identifier (URI). Wewnętrzny względny identyfikator URI może być ścieżką bezwzględną rozpoczynającą się od znaku ukośnika ("/"), takiego jak "/page1.xaml" lub "/images/picture4.jpg", albo ścieżki względnej, takiej jak ".. /imagespicture1.jpg", który rozpoznaje element główny pakietu ("/") jako podstawowy identyfikator URI.

Jeśli jest określona jako , może być bezwzględnym lub względnym identyfikatorem URI utworzonym zgodnie ze specyfikacją składni ogólnej RFC 3986Uniform Resource Identifier (URI). "https://www.microsoft.com/page2.xml" to przykład bezwzględnego identyfikatora URI, który odwołuje się do zewnętrznego zasobu docelowego "page2.xml". "images/picture1.jpg" to przykład względnego identyfikatora URI, który odwołuje się również do zewnętrznego zasobu docelowego "1.jpg", ale który rozpoznaje identyfikator URI samego pakietu.

musi być identyfikatorem URI utworzonym zgodnie z specyfikacją składni ogólnej RFC 3986Uniform Resource Identifier (URI). Różne typy pakietów mogą definiować różne typy relacji na poziomie części. W poniższej tabeli przedstawiono identyfikatory URI na poziomie części zdefiniowane dla dokumentów zgodnych zspecyfikacji open XML Paper Specification (XPS).

Relacja Part-Level dokumentu XPS Identyfikator URI typu relacji
Definicje podpisów cyfrowych http://schemas.microsoft.com/xps/2005/06/signature-definitions
Odrzućcontrol 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
Wymagany zasób http://schemas.microsoft.com/xps/2005/06/required-resource
Czcionka z ograniczeniami 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

Aby uzyskać więcej informacji na temat relacji pakietów, zobacz sekcję 1.3 specyfikacji Open Packaging Conventions (OPC) specyfikacji dostępnej do pobrania na stronie https://www.ecma-international.org/publications-and-standards/standards/ecma-376/.

Aby uzyskać więcej informacji na temat dokumentów XPS, zobacz specyfikacji open XML paper specification (XPS) dostępne do pobrania pod adresem .

Zobacz też

Dotyczy