PackagePart.CreateRelationship Metoda

Definicja

Przestrzeń nazw:

System.IO.Packaging

Zestaw:

System.IO.Packaging.dll

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.

• Między PackagePart źródłowym a PackagePart docelowym wewnątrz Package.

• Między PackagePart źródłowym a zasobem docelowym spoza pakietu.

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)

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

PackageRelationship

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

Wyjątki

InvalidOperationException

Część została usunięta.

-lub-

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

ArgumentNullException

targetUri lub relationshipType jest null.

ArgumentOutOfRangeException

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

ArgumentException

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.

IOException

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.

• Między PackagePart źródłowym a PackagePart docelowym wewnątrz Package.

• Między PackagePart źródłowym a zasobem docelowym spoza pakietu.

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ż

• CreateRelationship
• DeleteRelationship(String)
• GetRelationship(String)
• GetRelationships()
• GetRelationshipsByType(String)
• specyfikacji konwencji otwierania pakietów

CreateRelationship(Uri, TargetMode, String, String)

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

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

PackageRelationship

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

Wyjątki

InvalidOperationException

Część została usunięta.

-lub-

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

ArgumentNullException

targetUri lub relationshipType jest null.

ArgumentOutOfRangeException

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

ArgumentException

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.

IOException

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

XmlException

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.

• Między PackagePart źródłowym a PackagePart docelowym wewnątrz Package.

• Między PackagePart źródłowym a zasobem docelowym spoza pakietu.

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ż

• CreateRelationship
• DeleteRelationship(String)
• GetRelationship(String)
• GetRelationships()
• GetRelationshipsByType(String)
• specyfikacji konwencji otwierania pakietów