Package.CreateRelationship Package.CreateRelationship Package.CreateRelationship Method

정의

지정된 파트에 대한 패키지 수준 관계를 만듭니다.Creates a package-level relationship to a given part.

오버로드

CreateRelationship(Uri, TargetMode, String) CreateRelationship(Uri, TargetMode, String) CreateRelationship(Uri, TargetMode, String)

지정된 URI, 대상 모드 및 관계 형식을 가진 파트에 대한 패키지 수준 관계를 만듭니다.Creates a package-level relationship to a part with a given URI, target mode, and relationship type.

CreateRelationship(Uri, TargetMode, String, String) CreateRelationship(Uri, TargetMode, String, String) CreateRelationship(Uri, TargetMode, String, String)

지정된 URI, 대상 모드, 관계 형식 및 ID(식별자)identifier (ID)를 가진 파트에 대한 패키지 수준 관계를 만듭니다.Creates a package-level relationship to a part with a given URI, target mode, relationship type, and ID(식별자)identifier (ID).

예제

다음 예제에서는 만드는 방법을 보여 줍니다는 PackageRelationship 간에 Package 및 루트 문서 파트입니다.The following example illustrates creating a PackageRelationship between a Package and a root document part. 전체 샘플을 참조 하세요 패키지 작성 샘플합니다.For the complete sample, see Writing a Package Sample.

// 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 package-level relationship defines an association between the package and an associated target part or resource. 패키지 수준 관계는 두 가지 형식 중 하나일 수 있습니다.A package-level relationship can be one of two forms.

  • 간의 Package 대상 PackagePart 패키지에 포함 합니다.Between a Package to a target PackagePart inside the package.

  • 간에 Package 패키지 외부의 대상 리소스에 있습니다.Between a Package to a target resource outside the package.

패키지 관계를 패키지 관계의 "소유자"로 간주 됩니다.In a package-relationship the package is considered the "owner" of the relationship. 패키지 삭제 되 면 패키지를 소유한 모든 관계도 삭제 됩니다.When the package is deleted, all the relationships owned by the package are also deleted. 대상 파트 또는 어떤 방식으로 리소스 만들기 또는 관계를 삭제 프로세스를 물리적으로 변경 되지 않습니다.The process of creating or deleting the relationship does not physically alter the target part or resource in any way.

자세한 내용은에서 다운로드할 수 있는 OPC Open Packaging Conventions () 사양을 참조 https://go.microsoft.com/fwlink/?LinkID=71255합니다.For additional information, see the Open Packaging Conventions (OPC) specification available for download at https://go.microsoft.com/fwlink/?LinkID=71255.

CreateRelationship(Uri, TargetMode, String) CreateRelationship(Uri, TargetMode, String) CreateRelationship(Uri, TargetMode, String)

지정된 URI, 대상 모드 및 관계 형식을 가진 파트에 대한 패키지 수준 관계를 만듭니다.Creates a package-level relationship to a part with a given URI, target mode, and relationship type.

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

매개 변수

targetUri
Uri Uri Uri

대상 파트의 URI(Uniform Resource Identifier)uniform resource identifier (URI)입니다.The URI(Uniform Resource Identifier)uniform resource identifier (URI) of the target part.

targetMode
TargetMode TargetMode TargetMode

대상 파트가 패키지에 Internal인지 또는 External인지를 나타냅니다.Indicates if the target part is Internal or External to the package.

relationshipType
String String String

관계의 역할을 고유하게 정의하는 URI입니다.A URI that uniquely defines the role of the relationship.

반환

지정된 파트에 대한 패키지 수준 관계입니다.The package-level relationship to the specified part.

예외

targetUri 또는 relationshipTypenull인 경우targetUri or relationshipType is null.

targetUri 파트가 PackageRelationship이거나 targetModeInternal이고 targetUri가 절대 URI인 경우The targetUri part is a PackageRelationship, or targetMode is Internal and targetUri is an absolute URI.

targetMode의 값이 올바르지 않은 경우The value for targetMode is not valid.

패키지가 열려 있지 않은 경우(Dispose(Boolean) 또는 Close()가 호출된 경우)The package is not open (Dispose(Boolean) or Close() has been called).

패키지가 읽기 전용인 경우The package is read-only.

예제

다음 예제를 사용 하는 방법 CreateRelationship 만들려면를 PackageRelationship 간에 Package 및 루트 문서 파트입니다.The following example illustrates how to use CreateRelationship to create a PackageRelationship between a Package and a root document part. 전체 샘플을 참조 하세요 패키지 작성 샘플합니다.For the complete sample, see Writing a Package Sample.

// 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 package-level relationship defines an association between the package and an associated target part or resource. 패키지 수준 관계는 두 가지 형식 중 하나일 수 있습니다.A package-level relationship can be one of two forms.

  • 간에 Package 패키지는 대상 파트.Between a Package to a target part in the package.

  • 간에 Package 패키지 외부의 대상 리소스에 있습니다.Between a Package to a target resource outside the package.

패키지 관계를 패키지 관계의 "소유자"로 간주 됩니다.In a package-relationship the package is considered the "owner" of the relationship. 패키지 삭제 되 면 패키지를 소유한 모든 관계도 삭제 됩니다.When the package is deleted, all the relationships owned by the package are also deleted.

CreateRelationship 실제로 변경 하지 않습니다 대상 파트 또는 어떤 방식으로든에서 리소스입니다.CreateRelationship does not physically change the target part or resource in any way.

관계의 대상 다른 관계를 지정할 수 없습니다.The target of a relationship cannot be another relationship.

경우 targetMode 으로 지정 됩니다 Internal, targetUri 에 따라 구성 되는 상대 URI 여야 합니다 RFC 3986 제네릭 구문 식별자 URI (Uniform Resource) 사양입니다.If targetMode is specified as Internal, targetUri must be a relative URI that is formed according to the RFC 3986 Uniform Resource Identifier (URI) Generic Syntax specification. 내부 상대 URI로 시작 하는 슬래시 ("/") 문자 같은 중 하나는 절대 경로 수 "/ page1.xaml" 또는 "/ images/picture4.jpg", 또는 상대 경로와 같은 "... / imagespicture1.jpg "패키지 루트에 대해 ("/ ")에서 기본 URI로 확인 하는 합니다.The internal relative URI can be either an absolute path that starts with a forward slash ("/") character such as "/page1.xaml" or "/images/picture4.jpg", or a relative path such as "../imagespicture1.jpg" that resolves against the package root ("/") as the base URI.

하는 경우 targetMode 로 지정 됩니다 External, targetUri 하거나 절대 또는 상대 URI에 따라 구성 합니다 RFC 3986 제네릭 구문 식별자 URI (Uniform Resource) 사양입니다.If targetMode is specified as External, targetUri can be either an absolute or relative URI formed according to the RFC 3986 Uniform Resource Identifier (URI) Generic Syntax specification. http://www.microsoft.com/page2.xml "page2.xml" 외부 대상 리소스를 참조 하는 절대 URI의 예시입니다.http://www.microsoft.com/page2.xml is an example of an absolute URI that references an external target resource "page2.xml". "images/picture1.jpg"은 예를 외부 대상 리소스 "1.jpg"는 해결 되지만 패키지 자체의 URI에 대해 참조 되는 상대 URI입니다."images/picture1.jpg" is an example of a relative URI that also references an external target resource "1.jpg" but which resolves against the URI of the package itself.

relationshipType 이어야 합니다는 URIURI 에 따라 형성 된 합니다 RFC 3986 제네릭 구문 식별자 URI (Uniform Resource) 사양입니다.relationshipType must be a URIURI that is formed according to the RFC 3986 Uniform Resource Identifier (URI) Generic Syntax specification. 다음 표에서 패키지 수준 relationshipType OPC Open Packaging Conventions () 사양에 정의 된 Uri입니다.The following table shows the package-level relationshipType URIs defined by the Open Packaging Conventions (OPC) specification.

패키지 수준 관계Package-level Relationship 관계 유형 URIRelationship Type URI
핵심 속성Core Properties http://schemas.openxmlformats.org/package/2006/relationships/metadata/core-properties
디지털 서명Digital Signature http://schemas.openxmlformats.org/package/2006/relationships/digital-signature/signature
디지털 서명 인증서Digital Signature Certificate http://schemas.openxmlformats.org/package/2006/relationships/digital-signature/certificate
디지털 서명 원본Digital Signature Origin http://schemas.openxmlformats.org/package/2006/relationships/digital-signature/origin
미리 보기Thumbnail http://schemas.openxmlformats.org/package/2006/relationships/metadata/thumbnail

패키징 및 패키지 관계에 대 한 자세한 내용은 참조에서 다운로드할 수 있는 OPC Open Packaging Conventions () 사양의 섹션 1.3 https://go.microsoft.com/fwlink/?LinkID=71255합니다.For more information about packaging and package relationships, see section 1.3 of the Open Packaging Conventions (OPC) specification available for download at https://go.microsoft.com/fwlink/?LinkID=71255.

추가 정보

CreateRelationship(Uri, TargetMode, String, String) CreateRelationship(Uri, TargetMode, String, String) CreateRelationship(Uri, TargetMode, String, String)

지정된 URI, 대상 모드, 관계 형식 및 ID(식별자)identifier (ID)를 가진 파트에 대한 패키지 수준 관계를 만듭니다.Creates a package-level relationship to a part with a given URI, target mode, relationship type, and ID(식별자)identifier (ID).

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

매개 변수

targetUri
Uri Uri Uri

대상 파트의 URI(Uniform Resource Identifier)uniform resource identifier (URI)입니다.The URI(Uniform Resource Identifier)uniform resource identifier (URI) of the target part.

targetMode
TargetMode TargetMode TargetMode

대상 파트가 패키지에 Internal인지 또는 External인지를 나타냅니다.Indicates if the target part is Internal or External to the package.

relationshipType
String String String

관계의 역할을 고유하게 정의하는 URI입니다.A URI that uniquely defines the role of the relationship.

id
String String String

고유 XML 식별자입니다.A unique XML identifier.

반환

지정된 파트에 대한 패키지 수준 관계입니다.The package-level relationship to the specified part.

예외

targetUri 또는 relationshipTypenull인 경우targetUri or relationshipType is null.

targetUri 파트가 PackageRelationship이거나 targetModeInternal이고 targetUri가 절대 URI인 경우The targetUri part is a PackageRelationship, or targetMode is Internal and targetUri is an absolute URI.

targetMode의 값이 올바르지 않은 경우The value for targetMode is not valid.

패키지가 열려 있지 않은 경우(Dispose(Boolean) 또는 Close()가 호출된 경우)The package is not open (Dispose(Boolean) or Close() has been called).

패키지가 읽기 전용인 경우The package is read-only.

id가 올바른 XML 식별자가 아니거나 지정된 id의 파트가 이미 패키지에 있는 경우id is not a valid XML identifier; or a part with the specified id already occurs in the package.

예제

다음 예제를 사용 하는 방법 CreateRelationship 만들려면를 PackageRelationship 간에 Package 및 루트 문서 파트입니다.The following example illustrates how to use CreateRelationship to create a PackageRelationship between a Package and a root document part. 전체 샘플을 참조 하세요 패키지 작성 샘플합니다.For the complete sample, see Writing a Package Sample.

// 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 package-level relationship defines an association between the package and an associated target part or resource. 패키지 수준 관계는 두 가지 형식 중 하나일 수 있습니다.A package-level relationship can be one of two forms.

  • 간에 Package 패키지는 대상 파트.Between a Package to a target part in the package.

  • 간에 Package 패키지 외부의 대상 리소스에 있습니다.Between a Package to a target resource outside the package.

패키지 관계를 패키지 관계의 "소유자"로 간주 됩니다.In a package-relationship the package is considered the "owner" of the relationship. 패키지 삭제 되 면 패키지를 소유한 모든 관계도 삭제 됩니다.When the package is deleted, all the relationships owned by the package are also deleted.

CreateRelationship 실제로 변경 하지 않습니다 대상 파트 또는 어떤 방식으로든에서 리소스입니다.CreateRelationship does not physically change the target part or resource in any way.

관계의 대상 다른 관계를 지정할 수 없습니다.The target of a relationship cannot be another relationship.

id 올바른 XML 식별자 여야 합니다.id must be a valid XML identifier. id 형식은 xsd: ID 이며 XML 스키마 파트 2에 지정 된 명명 규칙을 따라야 합니다. 데이터 형식 사양 ( https://www.w3.org/TR/xmlschema-2/#ID참조).The id type is xsd:ID and must follow the naming conventions prescribed in the XML Schema Part 2: Datatypes specification (see https://www.w3.org/TR/xmlschema-2/#ID).

하는 경우 id 으로 지정 된 null 고유 ID가 자동으로 생성 됩니다.If id is specified as null a unique ID will be automatically generated. id 빈으로 지정 된 문자열이 올바르지 않습니다.An id specified by an empty string is not valid.

경우 targetMode 으로 지정 됩니다 Internal, targetUri 에 따라 구성 되는 상대 URI 여야 합니다 RFC 3986 제네릭 구문 식별자 URI (Uniform Resource) 사양입니다.If targetMode is specified as Internal, targetUri must be a relative URI that is formed according to the RFC 3986 Uniform Resource Identifier (URI) Generic Syntax specification. 내부 상대 URI로 시작 하는 슬래시 ("/") 문자 같은 중 하나는 절대 경로 수 "/ page1.xaml" 또는 "/ images/picture4.jpg", 또는 상대 경로와 같은 "... / imagespicture1.jpg "패키지 루트에 대해 ("/ ")에서 기본 URI로 확인 하는 합니다.The internal relative URI can be either an absolute path that starts with a forward slash ("/") character such as "/page1.xaml" or "/images/picture4.jpg", or a relative path such as "../imagespicture1.jpg" that resolves against the package root ("/") as the base URI.

하는 경우 targetMode 로 지정 됩니다 External, targetUri 하거나 절대 또는 상대 URI에 따라 구성 합니다 RFC 3986 제네릭 구문 식별자 URI (Uniform Resource) 사양입니다.If targetMode is specified as External, targetUri can be either an absolute or relative URI formed according to the RFC 3986 Uniform Resource Identifier (URI) Generic Syntax specification. http://www.microsoft.com/page2.xml "page2.xml" 외부 대상 리소스를 참조 하는 절대 URI의 예시입니다.http://www.microsoft.com/page2.xml is an example of an absolute URI that references an external target resource "page2.xml". "images/picture1.jpg"은 예를 외부 대상 리소스 "1.jpg"는 해결 되지만 패키지 자체의 URI에 대해 참조 되는 상대 URI입니다."images/picture1.jpg" is an example of a relative URI that also references an external target resource "1.jpg" but which resolves against the URI of the package itself.

relationshipType 에 따라 구성 되는 URI 여야 합니다 RFC 3986 제네릭 구문 식별자 URI (Uniform Resource) 사양입니다.relationshipType must be a URI that is formed according to the RFC 3986 Uniform Resource Identifier (URI) Generic Syntax specification. 다음 표에서 패키지 수준 relationshipType OPC Open Packaging Conventions () 사양에 정의 된 Uri입니다.The following table shows the package-level relationshipType URIs defined by the Open Packaging Conventions (OPC) specification.

패키지 수준 관계Package-level Relationship 관계 유형 URIRelationship Type URI
핵심 속성Core Properties http://schemas.openxmlformats.org/package/2006/relationships/metadata/core-properties
디지털 서명Digital Signature http://schemas.openxmlformats.org/package/2006/relationships/digital-signature/signature
디지털 서명 인증서Digital Signature Certificate http://schemas.openxmlformats.org/package/2006/relationships/digital-signature/certificate
디지털 서명 원본Digital Signature Origin http://schemas.openxmlformats.org/package/2006/relationships/digital-signature/origin
미리 보기Thumbnail http://schemas.openxmlformats.org/package/2006/relationships/metadata/thumbnail

패키지 및 패키지 관계에 대 한 자세한 내용은에서 다운로드할 수 있는 OPC Open Packaging Conventions () 사양의 섹션 1.3을 참조 하세요. https://go.microsoft.com/fwlink/?LinkID=71255합니다.For additional information about packaging and package relationships, see section 1.3 of the Open Packaging Conventions (OPC) specification available for download at https://go.microsoft.com/fwlink/?LinkID=71255.

추가 정보

적용 대상