PackagePart.CreateRelationship Yöntem

Tanım

Ad Alanı:

System.IO.Packaging

Bütünleştirilmiş Kod:

System.IO.Packaging.dll

Paket:

System.IO.Packaging v9.0.0-rc.2.24473.5

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

Aşırı Yüklemeler

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

• kaynak PackagePartPackageiçindeki hedef PackagePart arasında.

• Kaynak PackagePart paketin dışındaki bir hedef kaynağa.

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 https://www.ecma-international.org/publications-and-standards/standards/ecma-376/adresinden indirilebilen Açık Paketleme Kuralları (OPC) belirtiminin 1.3. bölümüne bakın.

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

CreateRelationship(Uri, TargetMode, String)

Kaynak:

PackagePart.cs

Bu PackagePart belirtilen hedef PackagePart veya dış kaynakla 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, hedef bölümün Packageiçinde olup olmadığını Internal; veya hedef Packagedışında bir kaynaksa External.

relationshipType

String

İlişkinin rolü.

Döndürülenler

PackageRelationship

Bu PackagePart 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 relationshipTypenull.

ArgumentOutOfRangeException

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

ArgumentException

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

-veya-

targetMode Internal olarak 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.

• kaynak PackagePartPackageiçindeki hedef PackagePart arasında.

• Kaynak PackagePart paketin dışındaki bir hedef kaynağa.

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.

targetMode Internalolarak belirtilirse, targetUriRFC 3986Tekdüzen Kaynak Tanımlayıcısı (URI) Genel Sözdizimi 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.

targetMode Externalolarak belirtilirse 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 bir mutlak 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 tabloda, Open XML Kağıt Belirtimi (XPS)uygun belgeler için tanımlanan parça düzeyi relationshipType URI'leri 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 https://www.ecma-international.org/publications-and-standards/standards/ecma-376/adresinden indirilebilen Açık Paketleme Kuralları (OPC) belirtiminin 1.3. bölümüne bakın.

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

Ayrıca bkz.

• CreateRelationship
• DeleteRelationship(String)
• GetRelationship(String)
• GetRelationships()
• GetRelationshipsByType(String)
• Açık Paketleme Kuralları Belirtimi

CreateRelationship(Uri, TargetMode, String, String)

Kaynak:

PackagePart.cs

Bu PackagePart belirtilen hedef PackagePart veya dış kaynakla 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, hedef bölümün Packageiçinde olup olmadığını Internal; veya hedef Packagedışında bir kaynaksa External.

relationshipType

String

İlişkinin rolü.

id

String

İlişki için benzersiz bir kimlik.

Döndürülenler

PackageRelationship

Bu PackagePart 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 relationshipTypenull.

ArgumentOutOfRangeException

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

ArgumentException

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

-veya-

targetMode Internal olarak 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 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.

• kaynak PackagePartPackageiçindeki hedef PackagePart arasında.

• Kaynak PackagePart paketin dışındaki bir hedef kaynağa.

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. id türü xsd:ID'dir ve XML Şeması Bölüm 2: Veri türleri belirtiminde belirtilen adlandırma kurallarını izlemelidir (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.

targetMode Internalolarak belirtilirse, targetUriRFC 3986Tekdüzen Kaynak Tanımlayıcısı (URI) Genel Sözdizimi 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.

targetMode Externalolarak belirtilirse 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 tabloda, Open XML Kağıt Belirtimi (XPS)uygun belgeler için tanımlanan parça düzeyi relationshipType URI'leri 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 https://www.ecma-international.org/publications-and-standards/standards/ecma-376/adresinden indirilebilen Açık Paketleme Kuralları (OPC) belirtiminin 1.3. bölümüne bakın.

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

Ayrıca bkz.

• CreateRelationship
• DeleteRelationship(String)
• GetRelationship(String)
• GetRelationships()
• GetRelationshipsByType(String)
• Açık Paketleme Kuralları Belirtimi