PackagePart.CreateRelationship Yöntem

  • Başvuru

Tanım

Ad Alanı:
System.IO.Packaging
Bütünleştirilmiş Kod:
System.IO.Packaging.dll
Bütünleştirilmiş Kod:
WindowsBase.dll
Paket:
System.IO.Packaging v8.0.1
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.

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
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.

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.

Şunlara uygulanır

CreateRelationship(Uri, TargetMode, String, String)

Kaynak:
PackagePart.cs
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);
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.

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.

Şunlara uygulanır