PackagePart.CreateRelationship PackagePart.CreateRelationship PackagePart.CreateRelationship Method

정의

PackagePart와 지정된 대상 PackagePart 또는 외부 리소스 간의 파트 수준 관계를 만듭니다.Creates a part-level relationship between this PackagePart to a specified target PackagePart or external resource.

오버로드

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

PackagePart와 지정된 대상 PackagePart 또는 외부 리소스 간의 파트 수준 관계를 만듭니다.Creates a part-level relationship between this PackagePart to a specified target PackagePart or external resource.

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

PackagePart와 지정된 대상 PackagePart 또는 외부 리소스 간의 파트 수준 관계를 만듭니다.Creates a part-level relationship between this PackagePart to a specified target PackagePart or external resource.

설명

파트 수준 관계를이 파트와 대상 파트 또는 리소스 간의 연결을 정의 합니다.A part-level relationship defines an association between this part and a target part or resource. 파트 수준 관계는 두 가지 형식 중 하나일 수 있습니다.A part-level relationship can be one of two forms.

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

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

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

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

자세한 내용은 XPS 문서 참조에 대 한 합니다 오픈 사양 XPS (XML Paper) 에서 다운로드할 수 있습니다 https://go.microsoft.com/fwlink/?LinkID=67000합니다.For more information about XPS documents see the Open XML Paper Specification (XPS) available for download at https://go.microsoft.com/fwlink/?LinkID=67000.

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

PackagePart와 지정된 대상 PackagePart 또는 외부 리소스 간의 파트 수준 관계를 만듭니다.Creates a part-level relationship between this PackagePart to a specified target PackagePart or external resource.

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

대상 파트의 URIURI입니다.The URIURI of the target part.

targetMode
TargetMode TargetMode TargetMode

열거형 값 중 하나입니다.One of the enumeration values. 예를 들어 대상 파트가 Internal 내부에 있으면 Package이고, 대상이 External 외부의 리소스이면 Package입니다.For example, Internal if the target part is inside the Package; or External if the target is a resource outside the Package.

relationshipType
String String String

관계의 역할입니다.The role of the relationship.

반환

PackagePart와 대상 PackagePart 또는 외부 리소스 간의 파트 수준 관계입니다.The part-level relationship between this PackagePart to the target PackagePart or external resource.

예외

파트가 삭제된 경우The part has been deleted.

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

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

targetMode 매개 변수가 유효한 TargetMode 열거형 값이 아닌 경우The targetMode parameter is not a valid TargetMode enumeration value.

targetUri로 식별된 파트가 관계인 경우. 관계의 대상은 다른 관계가 될 수 없습니다.The part identified by the targetUri is a relationship (the target of a relationship cannot be another relationship).

또는-or- targetModeInternal로 지정되었지만 targetUri가 절대적인 외부 URIURI인 경우targetMode is specified as Internal but targetUri is an absolute external URIURI.

패키지가 읽기 전용인 경우. 이 경우 새 관계를 추가할 수 없습니다.The package is read-only (a new relationship cannot be added).

설명

파트 수준 관계를이 파트와 대상 파트 또는 리소스 간의 연결을 정의 합니다.A part-level relationship defines an association between this part and a target part or resource. 파트 수준 관계는 두 가지 형식 중 하나일 수 있습니다.A part-level relationship can be one of two forms.

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

CreateRelationship 메서드 소스 파트 또는 대상 파트 또는 어떤 방식으로든에서 리소스 실제로 변경 하지 않습니다.The CreateRelationship method does not physically change either the source part, or 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 Identifier) 일반 구문을 사양입니다.If targetMode is specified as Internal, targetUri must be a relative URI that is formed in accordance with 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 Identifier) 일반 구문을사양입니다.If targetMode is specified as External, targetUri can be either an absolute or relative URI formed in accordance with the RFC 3986 Uniform Resource Identifier (URI) Generic Syntax specification. "https://www.microsoft.com/page2.xml" "page2.xml" 외부 대상 리소스를 참조 하는 절대 URI의 예시입니다."https://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 Identifier) 일반 구문을 사양입니다.relationshipType must be a URIURI that is formed according to the RFC 3986 Uniform Resource Identifier (URI) Generic Syntax specification. 다른 패키지 형식에는 다른 파트 수준 관계 유형을 정의할 수 있습니다.Different package types can define different part-level relationship types. 다음 표에서 파트 수준 relationshipType 준수 하는 문서에 대해 정의 된 Uri는 오픈 사양 XPS (XML Paper) 합니다.The following table shows the part-level relationshipType URIs defined for documents that conform to the Open XML Paper Specification (XPS).

XPS 문서 파트 수준 관계XPS Document Part-Level Relationship 관계 유형 URIRelationship Type URI
디지털 서명 정의Digital Signature Definitions http://schemas.microsoft.com/xps/2005/06/signature-definitions
DiscardControlDiscardControl http://schemas.microsoft.com/xps/2005/06/discard-control
DocumentStructureDocumentStructure http://schemas.microsoft.com/xps/2005/06/documentstructure
PrintTicketPrintTicket http://schemas.microsoft.com/xps/2005/06/printticket
필요한 리소스Required Resource http://schemas.microsoft.com/xps/2005/06/required-resource
제한 된 글꼴Restricted Font http://schemas.microsoft.com/xps/2005/06/restricted-font
StartPartStartPart http://schemas.microsoft.com/xps/2005/06/fixedrepresentation
StoryFragmentsStoryFragments http://schemas.microsoft.com/xps/2005/06/storyfragments

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

자세한 내용은 XPS 문서 참조에 대 한 합니다 오픈 사양 XPS (XML Paper) 에서 다운로드할 수 있습니다 http://go.microsoft.com/fwlink/?LinkID=67000 합니다.For more information about XPS documents see the Open XML Paper Specification (XPS) available for download at http://go.microsoft.com/fwlink/?LinkID=67000.

추가 정보

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

PackagePart와 지정된 대상 PackagePart 또는 외부 리소스 간의 파트 수준 관계를 만듭니다.Creates a part-level relationship between this PackagePart to a specified target PackagePart or external resource.

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

대상 파트의 URIURI입니다.The URIURI of the target part.

targetMode
TargetMode TargetMode TargetMode

열거형 값 중 하나입니다.One of the enumeration values. 예를 들어 대상 파트가 Internal 내부에 있으면 Package이고, 대상이 External 외부의 리소스이면 Package입니다.For example, Internal if the target part is inside the Package; or External if the target is a resource outside the Package.

relationshipType
String String String

관계의 역할입니다.The role of the relationship.

id
String String String

관계의 고유 ID입니다.A unique ID for the relationship.

반환

PackagePart와 대상 PackagePart 또는 외부 리소스 간의 파트 수준 관계입니다.The part-level relationship between this PackagePart to the target PackagePart or external resource.

예외

파트가 삭제된 경우The part has been deleted.

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

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

targetMode 매개 변수가 유효한 TargetMode 열거형 값이 아닌 경우The targetMode parameter is not a valid TargetMode enumeration value.

targetUri로 식별된 파트가 관계인 경우. 관계의 대상은 다른 관계가 될 수 없습니다.The part identified by the targetUri is a relationship (the target of a relationship cannot be another relationship).

또는-or- targetModeInternal로 지정되었지만 targetUri가 절대적인 외부 URIURI인 경우targetMode is specified as Internal but targetUri is an absolute external URIURI.

패키지가 읽기 전용인 경우. 이 경우 새 관계를 추가할 수 없습니다.The package is read-only (a new relationship cannot be added).

id가 올바른 XML 식별자가 아닌 경우id is not a valid XML identifier.

또는-or- 지정된 id의 파트가 이미 있는 경우A part with the specified id already exists.

설명

파트 수준 관계를이 파트와 대상 파트 또는 리소스 간의 연결을 정의 합니다.A part-level relationship defines an association between this part and a target part or resource. 파트 수준 관계는 두 가지 형식 중 하나일 수 있습니다.A part-level relationship can be one of two forms.

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

id 올바른 XML 식별자 여야 합니다.id must be a valid XML identifier. 합니다 id 형식은 xsd: id 이며에 지정 된 명명 규칙을 따라야 합니다 XML Schema Part 2: Datatypes 사양 (참조 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).

CreateRelationship 메서드 소스 파트 또는 대상 파트 또는 어떤 방식으로든에서 리소스 실제로 변경 하지 않습니다.The CreateRelationship method does not physically change either the source part, or 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 Identifier) 일반 구문을 사양입니다.If targetMode is specified as Internal, targetUri must be a relative URI that is formed in accordance with 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 Identifier) 일반 구문을사양입니다.If targetMode is specified as External, targetUri can be either an absolute or relative URI formed in accordance with the RFC 3986 Uniform Resource Identifier (URI) Generic Syntax specification. "https://www.microsoft.com/page2.xml"은 "page2.xml" 외부 대상 리소스를 참조 하는 절대 URI의 예입니다."https://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 Identifier) 일반 구문을 사양입니다.relationshipType must be a URIURI that is formed according to the RFC 3986 Uniform Resource Identifier (URI) Generic Syntax specification. 다른 패키지 형식에는 다른 파트 수준 관계 유형을 정의할 수 있습니다.Different package types can define different part-level relationship types. 다음 표에서 파트 수준 relationshipType 준수 하는 문서에 대해 정의 된 Uri는 오픈 사양 XPS (XML Paper) 합니다.The following table shows the part-level relationshipType URIs defined for documents that conform to the Open XML Paper Specification (XPS).

XPS 문서 파트 수준 관계XPS Document Part-Level Relationship 관계 유형 URIRelationship Type URI
디지털 서명 정의Digital Signature Definitions http://schemas.microsoft.com/xps/2005/06/signature-definitions
DiscardControlDiscardControl http://schemas.microsoft.com/xps/2005/06/discard-control
DocumentStructureDocumentStructure http://schemas.microsoft.com/xps/2005/06/documentstructure
PrintTicketPrintTicket http://schemas.microsoft.com/xps/2005/06/printticket
필요한 리소스Required Resource http://schemas.microsoft.com/xps/2005/06/required-resource
제한 된 글꼴Restricted Font http://schemas.microsoft.com/xps/2005/06/restricted-font
StartPartStartPart http://schemas.microsoft.com/xps/2005/06/fixedrepresentation
StoryFragmentsStoryFragments http://schemas.microsoft.com/xps/2005/06/storyfragments

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

자세한 내용은 XPS 문서 참조에 대 한 합니다 오픈 사양 XPS (XML Paper) 에서 다운로드할 수 있습니다 http://go.microsoft.com/fwlink/?LinkID=67000 합니다.For more information about XPS documents see the Open XML Paper Specification (XPS) available for download at http://go.microsoft.com/fwlink/?LinkID=67000.

추가 정보

적용 대상