PackagePart.CreateRelationship Yöntem

Tanım

Ad Alanı:

System.IO.Packaging

Bütünleştirilmiş Kod:

System.IO.Packaging.dll

Paket:

System.IO.Packaging v8.0.0

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

Aşırı Yüklemeler

CreateRelationship(Uri, TargetMode, String)	Bu PackagePart kaynakla belirtilen hedef PackagePart veya dış kaynak arasında bir parça düzeyi ilişki oluşturur.
CreateRelationship(Uri, TargetMode, String, String)	Bu PackagePart kaynakla belirtilen 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.

• Bir kaynak PackagePart ile içindeki Packagebir hedef PackagePart 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, bölümü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/Açık Paketleme Kuralları (OPC) 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

Bu PackagePart kaynakla belirtilen 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'si.

targetMode

TargetMode

Sabit listesi 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

Bunun PackagePart hedef PackagePart veya dış kaynakla 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 sabit listesi 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ğından PackagePart içindeki bir hedefe PackagePart arasında Package.

• Bir kaynaktan PackagePart paketin dışındaki hedef kaynağa kadar.

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ğı hiçbir şekilde fiziksel olarak değiştirmez.

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

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

olarak InternalbelirtilirsetargetMode, 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 ".. Temel URI olarak paket köküne ("/") göre çözümleyen /imagespicture1.jpg".

olarak ExternalbelirtilirsetargetMode, 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.

relationshipTypeRFC 3986Tekdüzen Kaynak Tanımlayıcısı (URI) Genel Söz Dizimi belirtimine göre oluşturulmuş bir URI olmalıdır. Farklı paket türleri, farklı parça düzeyi ilişki türlerini tanımlayabilir. Aşağıdaki tabloda, Open XML Kağıt Belirtimine (XPS) uygun belgeler için tanımlanan parça düzeyi relationshipType 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ıtlı 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/Open Packaging Conventions (OPC) 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.

Ayrıca bkz.

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

CreateRelationship(Uri, TargetMode, String, String)

Kaynak:

PackagePart.cs

Bu PackagePart kaynakla belirtilen 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'si.

targetMode

TargetMode

Sabit listesi 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

Bu PackagePart kaynakla hedef PackagePart 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 sabit listesi 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ümü içeren 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ğından PackagePart içindeki bir hedefe PackagePart arasında Package.

• Bir kaynaktan PackagePart paketin dışındaki hedef kaynağa kadar.

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ğı hiç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, herhangi bir şekilde kaynak bölümü veya hedef bölümü ya da kaynağı fiziksel olarak değiştirmez.

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

olarak InternalbelirtilirsetargetMode, 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 ".. Temel URI olarak paket köküne ("/") göre çözümleyen /imagespicture1.jpg".

olarak ExternalbelirtilirsetargetMode, 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.

relationshipTypeRFC 3986Tekdüzen Kaynak Tanımlayıcısı (URI) Genel Söz Dizimi belirtimine göre oluşturulmuş bir URI olmalıdır. Farklı paket türleri, farklı parça düzeyi ilişki türlerini tanımlayabilir. Aşağıdaki tabloda, Open XML Kağıt Belirtimine (XPS) uygun belgeler için tanımlanan parça düzeyi relationshipType 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ıtlı 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/Open Packaging Conventions (OPC) belirtiminin 1.3. bölümüne bakın.

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

Ayrıca bkz.

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