PackagePart.CreateRelationship 메서드

정의

네임스페이스:

System.IO.Packaging

어셈블리:

System.IO.Packaging.dll

지정된 대상 PackagePart 또는 외부 리소스에 대한 이 PackagePart 간에 부분 수준 관계를 만듭니다.

오버로드

CreateRelationship(Uri, TargetMode, String)	지정된 대상 PackagePart 또는 외부 리소스에 대한 이 PackagePart 간에 부분 수준 관계를 만듭니다.
CreateRelationship(Uri, TargetMode, String, String)	지정된 대상 PackagePart 또는 외부 리소스에 대한 이 PackagePart 간에 부분 수준 관계를 만듭니다.

설명

파트 수준 관계는 이 부분과 대상 부분 또는 리소스 간의 연결을 정의합니다. 부분 수준 관계는 두 가지 형식 중 하나일 수 있습니다.

• 원본 PackagePart 간에 Package내의 대상 PackagePart.

• 패키지 외부의 대상 리소스에 대한 원본 PackagePart 사이에 있습니다.

부분 관계에서 원본 부분은 관계의 "소유자"로 간주됩니다. 원본 파트가 삭제되면 파트가 소유한 모든 관계도 삭제됩니다. 관계를 만들거나 삭제하는 프로세스는 어떤 방식으로든 대상 부분 또는 리소스를 물리적으로 변경하지 않습니다.

CreateRelationship 메서드는 원본 부분이나 대상 부분 또는 리소스를 어떤 방식으로든 물리적으로 변경하지 않습니다.

관계의 대상은 다른 관계가 될 수 없습니다.

패키지 관계에 대한 자세한 내용은 https://www.ecma-international.org/publications-and-standards/standards/ecma-376/다운로드할 수 있는 OPC(Open Packaging Conventions) 사양의 섹션 1.3을 참조하세요.

XPS 문서에 대한 자세한 내용은 https://www.ecma-international.org/publications-and-standards/standards/ecma-388/다운로드할 수 있는 XPS(Open XML Paper Specification)를 참조하세요.

CreateRelationship(Uri, TargetMode, String)

지정된 대상 PackagePart 또는 외부 리소스에 대한 이 PackagePart 간에 부분 수준 관계를 만듭니다.

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

매개 변수

targetUri

Uri

대상 부분의 URI입니다.

targetMode

TargetMode

열거형 값 중 하나입니다. 예를 들어 대상 부분이 Package내에 있는지 Internal. 또는 대상이 Package외부의 리소스인 경우 External.

relationshipType

String

관계의 역할입니다.

반환

PackageRelationship

이 PackagePart 대상 PackagePart 또는 외부 리소스와의 부분 수준 관계입니다.

예외

InvalidOperationException

파트가 삭제되었습니다.

-또는-

Package 열려 있지 않습니다(Dispose(Boolean) 또는 Close() 호출됨).

ArgumentNullException

targetUri 또는 relationshipTypenull.

ArgumentOutOfRangeException

targetMode 매개 변수가 유효한 TargetMode 열거형 값이 아닙니다.

ArgumentException

targetUri 식별되는 부분은 관계입니다(관계의 대상은 다른 관계가 될 수 없음).

-또는-

targetMode Internal 지정되지만 targetUri 절대 외부 URI입니다.

IOException

패키지는 읽기 전용입니다(새 관계를 추가할 수 없음).

설명

파트 수준 관계는 이 부분과 대상 부분 또는 리소스 간의 연결을 정의합니다. 부분 수준 관계는 두 가지 형식 중 하나일 수 있습니다.

• 원본 PackagePart 간에 Package내의 대상 PackagePart.

• 패키지 외부의 대상 리소스에 대한 원본 PackagePart 사이에 있습니다.

부분 관계에서 원본 부분은 관계의 "소유자"로 간주됩니다. 원본 파트가 삭제되면 파트가 소유한 모든 관계도 삭제됩니다. 관계를 만들거나 삭제하는 프로세스는 어떤 방식으로든 대상 부분 또는 리소스를 물리적으로 변경하지 않습니다.

CreateRelationship 메서드는 원본 부분이나 대상 부분 또는 리소스를 어떤 방식으로든 물리적으로 변경하지 않습니다.

관계의 대상은 다른 관계가 될 수 없습니다.

targetMode Internal지정하는 경우 targetUriRFC 3986URI(Uniform Resource Identifier) 제네릭 구문 사양에 따라 형성된 상대 URI여야 합니다. 내부 상대 URI는 "/page1.xaml" 또는 "/images/picture4.jpg"와 같은 슬래시("/") 문자로 시작하는 절대 경로이거나 ".와 같은 상대 경로일 수 있습니다. /imagespicture1.jpg" - 패키지 루트("/")를 기본 URI로 확인합니다.

targetMode External지정하는 경우 targetUriRFC 3986URI(Uniform Resource Identifier) 제네릭 구문 사양에 따라 형성된 절대 또는 상대 URI일 수 있습니다. "https://www.microsoft.com/page2.xml" 외부 대상 리소스 "page2.xml"를 참조하는 절대 URI의 예입니다. "images/picture1.jpg"는 외부 대상 리소스 "1.jpg"을 참조하지만 패키지 자체의 URI에 대해 확인되는 상대 URI의 예입니다.

relationshipType RFC 3986URI(Uniform Resource Identifier) 제네릭 구문 사양에 따라 형성된 URI여야 합니다. 패키지 유형이 다르면 서로 다른 부분 수준 관계 유형을 정의할 수 있습니다. 다음 표에서는 XPS(Open XML Paper Specification)준수하는 문서에 대해 정의된 부분 수준 relationshipType URI를 보여 줍니다.

XPS 문서 Part-Level 관계	관계 유형 URI
디지털 서명 정의	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
필수 리소스	http://schemas.microsoft.com/xps/2005/06/required-resource
제한된 글꼴	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

패키지 관계에 대한 자세한 내용은 https://www.ecma-international.org/publications-and-standards/standards/ecma-376/다운로드할 수 있는 OPC(Open Packaging Conventions) 사양의 섹션 1.3을 참조하세요.

XPS 문서에 대한 자세한 내용은 https://www.ecma-international.org/publications-and-standards/standards/ecma-388/다운로드할 수 있는 XPS(Open XML Paper Specification) 참조하세요.

추가 정보

• CreateRelationship
• DeleteRelationship(String)
• GetRelationship(String)
• GetRelationships()
• GetRelationshipsByType(String)
• 개방형 패키징 규칙 사양

CreateRelationship(Uri, TargetMode, String, String)

지정된 대상 PackagePart 또는 외부 리소스에 대한 이 PackagePart 간에 부분 수준 관계를 만듭니다.

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

매개 변수

targetUri

Uri

대상 부분의 URI입니다.

targetMode

TargetMode

열거형 값 중 하나입니다. 예를 들어 대상 부분이 Package내에 있는지 Internal. 또는 대상이 Package외부의 리소스인 경우 External.

relationshipType

String

관계의 역할입니다.

id

String

관계의 고유 ID입니다.

반환

PackageRelationship

이 PackagePart 대상 PackagePart 또는 외부 리소스와의 부분 수준 관계입니다.

예외

InvalidOperationException

파트가 삭제되었습니다.

-또는-

Package 열려 있지 않습니다(Dispose(Boolean) 또는 Close() 호출됨).

ArgumentNullException

targetUri 또는 relationshipTypenull.

ArgumentOutOfRangeException

targetMode 매개 변수가 유효한 TargetMode 열거형 값이 아닙니다.

ArgumentException

targetUri 식별되는 부분은 관계입니다(관계의 대상은 다른 관계가 될 수 없음).

-또는-

targetMode Internal 지정되지만 targetUri 절대 외부 URI입니다.

IOException

패키지는 읽기 전용입니다(새 관계를 추가할 수 없음).

XmlException

id 유효한 XML 식별자가 아닙니다.

-또는-

지정된 id 있는 부분이 이미 있습니다.

설명

파트 수준 관계는 이 부분과 대상 부분 또는 리소스 간의 연결을 정의합니다. 부분 수준 관계는 두 가지 형식 중 하나일 수 있습니다.

• 원본 PackagePart 간에 Package내의 대상 PackagePart.

• 패키지 외부의 대상 리소스에 대한 원본 PackagePart 사이에 있습니다.

부분 관계에서 원본 부분은 관계의 "소유자"로 간주됩니다. 원본 파트가 삭제되면 파트가 소유한 모든 관계도 삭제됩니다. 관계를 만들거나 삭제하는 프로세스는 어떤 방식으로든 대상 부분 또는 리소스를 물리적으로 변경하지 않습니다.

id 유효한 XML 식별자여야 합니다. id 형식은 xsd:ID이며 XML 스키마 2부: 데이터 형식 사양에 규정된 명명 규칙을 따라야 합니다(https://www.w3.org/TR/xmlschema-2/#ID참조).

CreateRelationship 메서드는 원본 부분이나 대상 부분 또는 리소스를 어떤 방식으로든 물리적으로 변경하지 않습니다.

관계의 대상은 다른 관계가 될 수 없습니다.

targetMode Internal지정하는 경우 targetUriRFC 3986URI(Uniform Resource Identifier) 제네릭 구문 사양에 따라 형성된 상대 URI여야 합니다. 내부 상대 URI는 "/page1.xaml" 또는 "/images/picture4.jpg"와 같은 슬래시("/") 문자로 시작하는 절대 경로이거나 ".와 같은 상대 경로일 수 있습니다. /imagespicture1.jpg" - 패키지 루트("/")를 기본 URI로 확인합니다.

targetMode External지정하는 경우 targetUriRFC 3986URI(Uniform Resource Identifier) 제네릭 구문 사양에 따라 형성된 절대 또는 상대 URI일 수 있습니다. "https://www.microsoft.com/page2.xml" 는 "page2.xml외부 대상 리소스를 참조하는 절대 URI의 예입니다. "images/picture1.jpg"는 외부 대상 리소스 "1.jpg"을 참조하지만 패키지 자체의 URI에 대해 확인되는 상대 URI의 예입니다.

relationshipType RFC 3986URI(Uniform Resource Identifier) 제네릭 구문 사양에 따라 형성된 URI여야 합니다. 패키지 유형이 다르면 서로 다른 부분 수준 관계 유형을 정의할 수 있습니다. 다음 표에서는 XPS(Open XML Paper Specification)준수하는 문서에 대해 정의된 부분 수준 relationshipType URI를 보여 줍니다.

XPS 문서 Part-Level 관계	관계 유형 URI
디지털 서명 정의	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
필수 리소스	http://schemas.microsoft.com/xps/2005/06/required-resource
제한된 글꼴	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

패키지 관계에 대한 자세한 내용은 https://www.ecma-international.org/publications-and-standards/standards/ecma-376/다운로드할 수 있는 OPC(Open Packaging Conventions) 사양의 섹션 1.3을 참조하세요.

XPS 문서에 대한 자세한 내용은 https://www.ecma-international.org/publications-and-standards/standards/ecma-388/다운로드할 수 있는 XPS(Open XML Paper Specification) 참조하세요.

추가 정보

• CreateRelationship
• DeleteRelationship(String)
• GetRelationship(String)
• GetRelationships()
• GetRelationshipsByType(String)
• 개방형 패키징 규칙 사양