Package.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-preview.3.24172.9

Belirli bir parçayla paket düzeyinde ilişki oluşturur.

Aşırı Yüklemeler

CreateRelationship(Uri, TargetMode, String)	Belirli bir URI, hedef mod ve ilişki türüne sahip bir parçayla paket düzeyinde ilişki oluşturur.
CreateRelationship(Uri, TargetMode, String, String)	Belirli bir URI, hedef mod, ilişki türü ve tanımlayıcıya (Kimlik) sahip bir parçayla paket düzeyinde ilişki oluşturur.

Örnekler

Aşağıdaki örnekte, ile kök belge bölümü arasında oluşturma Package işlemi gösterilmektedirPackageRelationship.

// Add the Document part to the Package
PackagePart packagePartDocument =
    package.CreatePart(partUriDocument,
                   System.Net.Mime.MediaTypeNames.Text.Xml);

// Copy the data to the Document Part
using (FileStream fileStream = new FileStream(
       documentPath, FileMode.Open, FileAccess.Read))
{
    CopyStream(fileStream, packagePartDocument.GetStream());
}// end:using(fileStream) - Close and dispose fileStream.

// Add a Package Relationship to the Document Part
package.CreateRelationship(packagePartDocument.Uri,
                           TargetMode.Internal,
                           PackageRelationshipType);

' Add the Document part to the Package
Dim packagePartDocument As PackagePart = package.CreatePart(partUriDocument, System.Net.Mime.MediaTypeNames.Text.Xml)

' Copy the data to the Document Part
Using fileStream As New FileStream(documentPath, FileMode.Open, FileAccess.Read)
    CopyStream(fileStream, packagePartDocument.GetStream())
End Using ' end:using(fileStream) - Close and dispose fileStream.

' Add a Package Relationship to the Document Part
package.CreateRelationship(packagePartDocument.Uri, TargetMode.Internal, PackageRelationshipType)

Açıklamalar

Paket düzeyinde ilişki, paket ile ilişkili bir hedef parça veya kaynak arasındaki ilişkiyi tanımlar. Paket düzeyi ilişki iki biçimden biri olabilir.

• Package Paketin içindeki bir hedefle PackagePart arasında.
• Package Paketin dışındaki bir hedef kaynağa arasında.

Paket ilişkisinde paket, ilişkinin "sahibi" olarak kabul edilir. Paket silindiğinde, paketin 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.

Ek bilgi için adresinden indirilebilen https://www.ecma-international.org/publications-and-standards/standards/ecma-376/Open Packaging Conventions (OPC) belirtimine bakın.

CreateRelationship(Uri, TargetMode, String)

Kaynak:

Package.cs

Belirli bir URI, hedef mod ve ilişki türüne sahip bir parçayla paket düzeyinde 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 tekdüzen kaynak tanımlayıcısı (URI).

targetMode

TargetMode

Hedef bölümün pakete mi yoksa External pakete mi ait olduğunu Internal gösterir.

relationshipType

String

İlişkinin rolünü benzersiz olarak tanımlayan bir URI.

Döndürülenler

PackageRelationship

Belirtilen bölümle paket düzeyi ilişkisi.

Özel durumlar

ArgumentNullException

targetUri veya relationshipType şeklindedir null.

ArgumentException

targetUri bölümü bir PackageRelationshipveya targetMode ve InternaltargetUri mutlak bir URI'dir.

ArgumentOutOfRangeException

değeri targetMode geçerli değil.

ObjectDisposedException

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

IOException

Paket salt okunurdur.

Örnekler

Aşağıdaki örnekte, ile Package kök belge bölümü arasında bir oluşturmak PackageRelationship için nasıl kullanılacağı CreateRelationship gösterilmektedir.

// Add the Document part to the Package
PackagePart packagePartDocument =
    package.CreatePart(partUriDocument,
                   System.Net.Mime.MediaTypeNames.Text.Xml);

// Copy the data to the Document Part
using (FileStream fileStream = new FileStream(
       documentPath, FileMode.Open, FileAccess.Read))
{
    CopyStream(fileStream, packagePartDocument.GetStream());
}// end:using(fileStream) - Close and dispose fileStream.

// Add a Package Relationship to the Document Part
package.CreateRelationship(packagePartDocument.Uri,
                           TargetMode.Internal,
                           PackageRelationshipType);

' Add the Document part to the Package
Dim packagePartDocument As PackagePart = package.CreatePart(partUriDocument, System.Net.Mime.MediaTypeNames.Text.Xml)

' Copy the data to the Document Part
Using fileStream As New FileStream(documentPath, FileMode.Open, FileAccess.Read)
    CopyStream(fileStream, packagePartDocument.GetStream())
End Using ' end:using(fileStream) - Close and dispose fileStream.

' Add a Package Relationship to the Document Part
package.CreateRelationship(packagePartDocument.Uri, TargetMode.Internal, PackageRelationshipType)

Açıklamalar

Paket düzeyinde ilişki, paket ile ilişkili bir hedef parça veya kaynak arasındaki ilişkiyi tanımlar. Paket düzeyi ilişki iki biçimden biri olabilir.

• Package Paketin hedef bölümü arasında.
• Package Paketin dışındaki bir hedef kaynağa arasında.

Paket ilişkisinde paket, ilişkinin "sahibi" olarak kabul edilir. Paket silindiğinde, paketin sahip olduğu tüm ilişkiler de silinir.

CreateRelationship hedef bölümü veya kaynağı herhangi bir şekilde fiziksel olarak değiştirmez.

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

olarak InternalbelirtilirsetargetMode, targetUriRFC 3986 Tekdüzen Kaynak Tanımlayıcısı (URI) Genel Söz Dizimi belirtimine göre 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 3986 Tekdüzen Kaynak Tanımlayıcısı (URI) Genel Söz Dizimi belirtimine göre oluşturulmuş mutlak veya göreli bir URI olabilir. http://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.

relationshipTypeRFC 3986 Tekdüzen Kaynak Tanımlayıcısı (URI) Genel Sözdizimi belirtimine göre oluşturulmuş bir URI olmalıdır. Aşağıdaki tabloda Open Packaging Conventions (OPC) belirtimi tarafından tanımlanan paket düzeyi relationshipType URI'ler gösterilmektedir.

Paket Düzeyinde İlişki	İlişki Türü URI'si
Temel Özellikler	http://schemas.openxmlformats.org/package/2006/relationships/metadata/core-properties
Dijital İmza	http://schemas.openxmlformats.org/package/2006/relationships/digital-signature/signature
Dijital İmza Sertifikası	http://schemas.openxmlformats.org/package/2006/relationships/digital-signature/certificate
Dijital İmza Kaynağı	http://schemas.openxmlformats.org/package/2006/relationships/digital-signature/origin
Küçük	http://schemas.openxmlformats.org/package/2006/relationships/metadata/thumbnail

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

Ayrıca bkz.

• DeleteRelationship(String)
• GetRelationship(String)
• GetRelationships()
• GetRelationshipsByType(String)
• RelationshipExists(String)

CreateRelationship(Uri, TargetMode, String, String)

Kaynak:

Package.cs

Belirli bir URI, hedef mod, ilişki türü ve tanımlayıcıya (Kimlik) sahip bir parçayla paket düzeyinde 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 tekdüzen kaynak tanımlayıcısı (URI).

targetMode

TargetMode

Hedef bölümün pakete mi yoksa External pakete mi ait olduğunu Internal gösterir.

relationshipType

String

İlişkinin rolünü benzersiz olarak tanımlayan bir URI.

id

String

Benzersiz bir XML tanımlayıcısı.

Döndürülenler

PackageRelationship

Belirtilen bölümle paket düzeyi ilişkisi.

Özel durumlar

ArgumentNullException

targetUri veya relationshipType şeklindedir null.

ArgumentException

targetUri bölümü bir PackageRelationshipveya targetMode ve InternaltargetUri mutlak bir URI'dir.

ArgumentOutOfRangeException

değeri targetMode geçerli değil.

ObjectDisposedException

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

IOException

Paket salt okunurdur.

XmlException

id geçerli bir XML tanımlayıcısı değildir; veya belirtilene id sahip bir bölüm pakette zaten yer alır.

Örnekler

Aşağıdaki örnekte, ile Package kök belge bölümü arasında bir oluşturmak PackageRelationship için nasıl kullanılacağı CreateRelationship gösterilmektedir.

// Add the Document part to the Package
PackagePart packagePartDocument =
    package.CreatePart(partUriDocument,
                   System.Net.Mime.MediaTypeNames.Text.Xml);

// Copy the data to the Document Part
using (FileStream fileStream = new FileStream(
       documentPath, FileMode.Open, FileAccess.Read))
{
    CopyStream(fileStream, packagePartDocument.GetStream());
}// end:using(fileStream) - Close and dispose fileStream.

// Add a Package Relationship to the Document Part
package.CreateRelationship(packagePartDocument.Uri,
                           TargetMode.Internal,
                           PackageRelationshipType);

' Add the Document part to the Package
Dim packagePartDocument As PackagePart = package.CreatePart(partUriDocument, System.Net.Mime.MediaTypeNames.Text.Xml)

' Copy the data to the Document Part
Using fileStream As New FileStream(documentPath, FileMode.Open, FileAccess.Read)
    CopyStream(fileStream, packagePartDocument.GetStream())
End Using ' end:using(fileStream) - Close and dispose fileStream.

' Add a Package Relationship to the Document Part
package.CreateRelationship(packagePartDocument.Uri, TargetMode.Internal, PackageRelationshipType)

Açıklamalar

Paket düzeyinde ilişki, paket ile ilişkili bir hedef parça veya kaynak arasındaki ilişkiyi tanımlar. Paket düzeyi ilişki iki biçimden biri olabilir.

• Package Paketin hedef bölümü arasında.
• Package Paketin dışındaki bir hedef kaynağa arasında.

Paket ilişkisinde paket, ilişkinin "sahibi" olarak kabul edilir. Paket silindiğinde, paketin sahip olduğu tüm ilişkiler de silinir.

CreateRelationship hedef bölümü veya kaynağı herhangi bir şekilde fiziksel olarak değiştirmez.

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

id geçerli bir XML tanımlayıcısı olmalıdır. Tür id xsd:ID'dir ve XML Şeması 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. ).

Benzersiz kimlik olarak null belirtilirse id otomatik olarak oluşturulur. Boş id bir dize tarafından belirtilen geçerli değil.

olarak InternalbelirtilirsetargetMode, targetUriRFC 3986 Tekdüzen Kaynak Tanımlayıcısı (URI) Genel Söz Dizimi belirtimine göre 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 3986 Tekdüzen Kaynak Tanımlayıcısı (URI) Genel Söz Dizimi belirtimine göre oluşturulmuş mutlak veya göreli bir URI olabilir. http://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.

relationshipTypeRFC 3986 Tekdüzen Kaynak Tanımlayıcısı (URI) Genel Sözdizimi belirtimine göre oluşturulmuş bir URI olmalıdır. Aşağıdaki tabloda Open Packaging Conventions (OPC) belirtimi tarafından tanımlanan paket düzeyi relationshipType URI'ler gösterilmektedir.

Paket Düzeyinde İlişki	İlişki Türü URI'si
Temel Özellikler	http://schemas.openxmlformats.org/package/2006/relationships/metadata/core-properties
Dijital İmza	http://schemas.openxmlformats.org/package/2006/relationships/digital-signature/signature
Dijital İmza Sertifikası	http://schemas.openxmlformats.org/package/2006/relationships/digital-signature/certificate
Dijital İmza Kaynağı	http://schemas.openxmlformats.org/package/2006/relationships/digital-signature/origin
Küçük	http://schemas.openxmlformats.org/package/2006/relationships/metadata/thumbnail

Paketleme ve paket ilişkileri hakkında ek 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.

Ayrıca bkz.

• CreateRelationship(Uri, TargetMode, String)
• DeleteRelationship(String)
• GetRelationship(String)
• GetRelationships()
• GetRelationshipsByType(String)
• RelationshipExists(String)