PackagePart.CreateRelationship Metoda

Definicja

Przestrzeń nazw:

System.IO.Packaging

Zestaw:

System.IO.Packaging.dll

Pakiet:

System.IO.Packaging v8.0.0

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

Przeciążenia

CreateRelationship(Uri, TargetMode, String)	Tworzy relację na poziomie części między tą PackagePart relacją z określonym zasobem docelowym PackagePart lub zewnętrznym.
CreateRelationship(Uri, TargetMode, String, String)	Tworzy relację na poziomie części między tą PackagePart relacją z określonym zasobem docelowym PackagePart lub 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 źródłem PackagePart a obiektem docelowym PackagePart wewnątrz obiektu Package.

• Między źródłem PackagePart a zasobem docelowym poza pakietem.

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.

Element docelowy relacji nie może być inną relacją.

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

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

CreateRelationship(Uri, TargetMode, String)

Źródło:

PackagePart.cs

Tworzy relację na poziomie części między tą PackagePart relacją z określonym zasobem docelowym PackagePart lub 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. Jeśli na przykład Internal część docelowa znajduje się wewnątrz Packageelementu ; lub External jeśli element docelowy jest zasobem poza elementem Package.

relationshipType

String

Rola relacji.

Zwraca

PackageRelationship

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

Wyjątki

InvalidOperationException

Część została usunięta.

-lub-

Element Package nie jest otwarty (Dispose(Boolean) lub Close() został wywołany).

ArgumentNullException

targetUri lub relationshipType ma wartość null.

ArgumentOutOfRangeException

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

ArgumentException

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

-lub-

targetMode parametr 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 źródłem PackagePart a obiektem docelowym PackagePart wewnątrz obiektu Package.

• Między źródłem PackagePart a zasobem docelowym poza pakietem.

W relacji części część część źródłowa jest uznawana za "właściciela" 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 ani zasobu w żaden sposób.

Celem relacji nie może być inna relacja.

Jeśli targetMode parametr jest określony jako Internal, targetUri musi być względnym identyfikatorem URI, który jest tworzony 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 jest rozpoznawany względem katalogu głównego pakietu ("/") jako identyfikatora URI podstawowego.

Jeśli targetMode parametr jest określony jako External, targetUri 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 jest rozpoznawany względem identyfikatora URI samego pakietu.

relationshipTypemusi być identyfikatorem URI, który jest tworzony zgodnie ze specyfikacją składni ogólnej identyfikatora URI (Uniform Resource Identifier)RFC 3986. Różne typy pakietów mogą definiować różne typy relacji na poziomie części. W poniższej tabeli przedstawiono identyfikatory URI na poziomie relationshipType części zdefiniowane dla dokumentów zgodnych ze specyfikacją 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) dostępnej do pobrania pod adresem https://www.ecma-international.org/publications-and-standards/standards/ecma-376/.

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

Zobacz też

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

CreateRelationship(Uri, TargetMode, String, String)

Źródło:

PackagePart.cs

Tworzy relację na poziomie części między tym PackagePart elementem docelowym PackagePart 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. Jeśli na przykład Internal część docelowa znajduje się wewnątrz Packageelementu ; lub External jeśli element docelowy jest zasobem poza elementem Package.

relationshipType

String

Rola relacji.

id

String

Unikatowy identyfikator relacji.

Zwraca

PackageRelationship

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

Wyjątki

InvalidOperationException

Część została usunięta.

-lub-

Element Package nie jest otwarty (Dispose(Boolean) lub Close() został wywołany).

ArgumentNullException

targetUri lub relationshipType ma wartość null.

ArgumentOutOfRangeException

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

ArgumentException

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

-lub-

targetMode parametr 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 źródłem PackagePart a obiektem docelowym PackagePart wewnątrz obiektu Package.

• Między źródłem PackagePart a zasobem docelowym poza pakietem.

W relacji części część część źródłowa jest uznawana za "właściciela" 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 być zgodny z konwencjami nazewnictwa określonymi w specyfikacji Schemat XML Część 2: Specyfikacja typów danych (patrz https://www.w3.org/TR/xmlschema-2/#ID).

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

Celem relacji nie może być inna relacja.

Jeśli targetMode parametr jest określony jako Internal, targetUri musi być względnym identyfikatorem URI, który jest tworzony 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 jest rozpoznawany względem katalogu głównego pakietu ("/") jako identyfikatora URI podstawowego.

Jeśli targetMode parametr jest określony jako External, targetUri 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 jest rozpoznawany względem identyfikatora URI samego pakietu.

relationshipTypemusi być identyfikatorem URI, który jest tworzony zgodnie ze specyfikacją składni ogólnej identyfikatora URI (Uniform Resource Identifier)RFC 3986. Różne typy pakietów mogą definiować różne typy relacji na poziomie części. W poniższej tabeli przedstawiono identyfikatory URI na poziomie relationshipType części zdefiniowane dla dokumentów zgodnych ze specyfikacją 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) dostępnej do pobrania pod adresem https://www.ecma-international.org/publications-and-standards/standards/ecma-376/.

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

Zobacz też

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