PackagePart.CreateRelationship Yöntem

Tanım

Ad Alanı:

System.IO.Packaging

Bütünleştirilmiş Kod:

System.IO.Packaging.dll

Paket:

System.IO.Packaging v11.0.0-preview.4.26230.115

Belirtilen PackagePart hedef PackagePart veya dış kaynak arasında bir parça düzeyi ilişki oluşturur.

Aşırı Yüklemeler

Name	Description
CreateRelationship(Uri, TargetMode, String)	Belirtilen PackagePart hedef PackagePart veya dış kaynak arasında bir parça düzeyi ilişki oluşturur.
CreateRelationship(Uri, TargetMode, String, String)	Belirtilen PackagePart hedef PackagePart veya dış kaynak arasında bir parça düzeyi ilişki oluşturur.

Açıklamalar

Parça düzeyi ilişki, bu bölümle hedef parça veya kaynak arasındaki ilişkiyi tanımlar. Parça düzeyi ilişki iki biçimden biri olabilir.

• kaynağı PackagePart ile içindeki PackagePartbir hedef Package arasında.

• Kaynak PackagePart ile paketin dışındaki bir hedef kaynak arasında.

Bir parça ilişkisinde, kaynak bölüm ilişkinin "sahibi" olarak kabul edilir. Kaynak bölüm silindiğinde, parçanın sahip olduğu tüm ilişkiler de silinir. İlişki oluşturma veya silme işlemi, hedef bölümü veya kaynağı herhangi bir şekilde fiziksel olarak değiştirmez.

CreateRelationship yöntemi, kaynak bölümü veya hedef bölümü ya da kaynağı herhangi bir şekilde fiziksel olarak değiştirmez.

Bir ilişkinin hedefi başka bir ilişki olamaz.

Paket ilişkileri hakkında daha fazla bilgi için adresinden indirilebilen https://www.ecma-international.org/publications-and-standards/standards/ecma-376/ belirtiminin 1.3. bölümüne bakın.

XPS belgeleri hakkında daha fazla bilgi için, adresinden indirilebilen https://www.ecma-international.org/publications-and-standards/standards/ecma-388/Open XML Paper Specification (XPS) bölümüne bakın.

CreateRelationship(Uri, TargetMode, String)

Kaynak:

PackagePart.cs

Belirtilen PackagePart hedef PackagePart veya dış kaynak arasında bir parça düzeyi ilişki oluşturur.

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

Parametreler

targetUri

Uri

Hedef bölümün URI'sini.

targetMode

TargetMode

Numaralandırma değerlerinden biri. Örneğin, Internal hedef bölüm içindeyse Packageveya External hedef öğesinin dışında Packagebir kaynaksa.

relationshipType

String

İlişkinin rolü.

Döndürülenler

PackageRelationship

Hedef PackagePartPackagePart veya dış kaynak arasındaki parça düzeyi ilişki.

Özel durumlar

InvalidOperationException

Bölüm silindi.

-veya-

Package açık değil (Dispose(Boolean)veya Close() çağrıldı).

ArgumentNullException

targetUri veya relationshipType şeklindedir null.

ArgumentOutOfRangeException

targetMode parametresi geçerli TargetMode bir numaralandırma değeri değil.

ArgumentException

tarafından targetUri tanımlanan bölüm bir ilişkidir (bir ilişkinin hedefi başka bir ilişki olamaz).

-veya-

targetMode olarak Internal belirtilir ancak targetUri mutlak bir dış URI'dir.

IOException

Paket salt okunurdur (yeni bir ilişki eklenemez).

Açıklamalar

Parça düzeyi ilişki, bu bölümle hedef parça veya kaynak arasındaki ilişkiyi tanımlar. Parça düzeyi ilişki iki biçimden biri olabilir.

• kaynağı PackagePart ile içindeki PackagePartbir hedef Package arasında.
• Kaynak PackagePart ile paketin dışındaki bir hedef kaynak arasında.

Bir parça ilişkisinde, kaynak bölüm ilişkinin "sahibi" olarak kabul edilir. Kaynak bölüm silindiğinde, parçanın sahip olduğu tüm ilişkiler de silinir. İlişki oluşturma veya silme işlemi, hedef bölümü veya kaynağı herhangi bir şekilde fiziksel olarak değiştirmez.

CreateRelationship yöntemi, kaynak bölümü veya hedef bölümü ya da kaynağı herhangi bir şekilde fiziksel olarak değiştirmez.

Bir ilişkinin hedefi başka bir ilişki olamaz.

olarak targetModebelirtilirseInternal, targetUriRFC 3986Tekdüzen Kaynak Tanımlayıcısı (URI) Genel Söz Dizimi belirtimine uygun olarak oluşturulmuş göreli bir URI olmalıdır. İç göreli URI, "/page1.xaml" veya "/images/picture4.jpg" gibi eğik çizgi ("/") karakteriyle başlayan mutlak bir yol veya ".. /imagespicture1.jpg" temel URI olarak paket köküne ("/") göre çözümlenebilir.

olarak targetModebelirtilirseExternal, targetUriRFC 3986Tekdüzen Kaynak Tanımlayıcısı (URI) Genel Söz Dizimi belirtimine uygun olarak oluşturulmuş mutlak veya göreli bir URI olabilir. "https://www.microsoft.com/page2.xml" , "page2.xml" dış hedef kaynağına başvuran mutlak bir URI örneğidir. "images/picture1.jpg", "1.jpg" dış hedef kaynağına da başvuran ancak paketin URI'sine karşı çözümlenen göreli bir URI örneğidir.

relationshipType RFC 3986Tekdüzen Kaynak Tanımlayıcısı (URI) Genel Sözdizimi belirtimine göre oluşturulmuş bir URI olmalıdır. Farklı paket türleri farklı parça düzeyi ilişki türleri tanımlayabilir. Aşağıdaki tablodarelationshipType uygun belgeler için tanımlanan parça düzeyi URI'ler gösterilmektedir.

XPS Belge Part-Level İlişkisi	İlişki Türü URI'si
Dijital İmza Tanımları	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
Gerekli Kaynak	http://schemas.microsoft.com/xps/2005/06/required-resource
Kısıtlanmış Yazı Tipi	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

Paket ilişkileri hakkında daha fazla bilgi için adresinden indirilebilen https://www.ecma-international.org/publications-and-standards/standards/ecma-376/ belirtiminin 1.3. bölümüne bakın.

XPS belgeleri hakkında daha fazla bilgi için, adresinden indirilebilen https://www.ecma-international.org/publications-and-standards/standards/ecma-388/ bölümüne bakın.

Ayrıca bkz.

• CreateRelationship
• DeleteRelationship(String)
• GetRelationship(String)
• GetRelationships()
• GetRelationshipsByType(String)
• Open Packaging Conventions Belirtimi

CreateRelationship(Uri, TargetMode, String, String)

Kaynak:

PackagePart.cs

Belirtilen PackagePart hedef PackagePart veya dış kaynak arasında bir parça düzeyi ilişki oluşturur.

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

Parametreler

targetUri

Uri

Hedef bölümün URI'sini.

targetMode

TargetMode

Numaralandırma değerlerinden biri. Örneğin, Internal hedef bölüm içindeyse Packageveya External hedef öğesinin dışında Packagebir kaynaksa.

relationshipType

String

İlişkinin rolü.

id

String

İlişki için benzersiz bir kimlik.

Döndürülenler

PackageRelationship

Hedef PackagePartPackagePart veya dış kaynak arasındaki parça düzeyi ilişki.

Özel durumlar

InvalidOperationException

Bölüm silindi.

-veya-

Package açık değil (Dispose(Boolean)veya Close() çağrıldı).

ArgumentNullException

targetUri veya relationshipType şeklindedir null.

ArgumentOutOfRangeException

targetMode parametresi geçerli TargetMode bir numaralandırma değeri değil.

ArgumentException

tarafından targetUri tanımlanan bölüm bir ilişkidir (bir ilişkinin hedefi başka bir ilişki olamaz).

-veya-

targetMode olarak Internal belirtilir ancak targetUri mutlak bir dış URI'dir.

IOException

Paket salt okunurdur (yeni bir ilişki eklenemez).

XmlException

id geçerli bir XML tanımlayıcısı değil.

-veya-

Belirtilen id bölüme sahip bir bölüm zaten var.

Açıklamalar

Parça düzeyi ilişki, bu bölümle hedef parça veya kaynak arasındaki ilişkiyi tanımlar. Parça düzeyi ilişki iki biçimden biri olabilir:

• kaynağı PackagePart ile içindeki PackagePartbir hedef Package arasında.
• Kaynak PackagePart ile paketin dışındaki bir hedef kaynak arasında.

Bir parça ilişkisinde, kaynak bölüm ilişkinin "sahibi" olarak kabul edilir. Kaynak bölüm silindiğinde, parçanın sahip olduğu tüm ilişkiler de silinir. İlişki oluşturma veya silme işlemi, hedef bölümü veya kaynağı herhangi bir şekilde fiziksel olarak değiştirmez.

id geçerli bir XML tanımlayıcısı olmalıdır. Tür id xsd:ID'dir ve XML Şema Bölüm 2: Veri türleri belirtiminde belirtilen adlandırma kurallarına uygun olmalıdır (bkz https://www.w3.org/TR/xmlschema-2/#ID. ).

CreateRelationship yöntemi, kaynak bölümü veya hedef bölümü ya da kaynağı herhangi bir şekilde fiziksel olarak değiştirmez.

Bir ilişkinin hedefi başka bir ilişki olamaz.

olarak targetModebelirtilirseInternal, targetUriRFC 3986Tekdüzen Kaynak Tanımlayıcısı (URI) Genel Söz Dizimi belirtimine uygun olarak oluşturulmuş göreli bir URI olmalıdır. İç göreli URI, "/page1.xaml" veya "/images/picture4.jpg" gibi eğik çizgi ("/") karakteriyle başlayan mutlak bir yol veya ".. /imagespicture1.jpg" temel URI olarak paket köküne ("/") göre çözümlenebilir.

olarak targetModebelirtilirseExternal, targetUriRFC 3986Tekdüzen Kaynak Tanımlayıcısı (URI) Genel Söz Dizimi belirtimine uygun olarak oluşturulmuş mutlak veya göreli bir URI olabilir. "https://www.microsoft.com/page2.xml" , "page2.xml" dış hedef kaynağına başvuran mutlak bir URI örneğidir. "images/picture1.jpg", "1.jpg" dış hedef kaynağına da başvuran ancak paketin URI'sine karşı çözümlenen göreli bir URI örneğidir.

relationshipType RFC 3986Tekdüzen Kaynak Tanımlayıcısı (URI) Genel Sözdizimi belirtimine göre oluşturulmuş bir URI olmalıdır. Farklı paket türleri farklı parça düzeyi ilişki türleri tanımlayabilir. Aşağıdaki tablodarelationshipType uygun belgeler için tanımlanan parça düzeyi URI'ler gösterilmektedir.

XPS Belge Part-Level İlişkisi	İlişki Türü URI'si
Dijital İmza Tanımları	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
Gerekli Kaynak	http://schemas.microsoft.com/xps/2005/06/required-resource
Kısıtlanmış Yazı Tipi	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

Paket ilişkileri hakkında daha fazla bilgi için adresinden indirilebilen https://www.ecma-international.org/publications-and-standards/standards/ecma-376/ belirtiminin 1.3. bölümüne bakın.

XPS belgeleri hakkında daha fazla bilgi için adresinden indirilebilen https://www.ecma-international.org/publications-and-standards/standards/ecma-388/ bölümüne bakın.

Ayrıca bkz.

• CreateRelationship
• DeleteRelationship(String)
• GetRelationship(String)
• GetRelationships()
• GetRelationshipsByType(String)
• Open Packaging Conventions Belirtimi