PackagePart.CreateRelationship 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
이 PackagePart와 지정된 대상 PackagePart 또는 외부 리소스 간의 파트 수준 관계를 만듭니다.
오버로드
CreateRelationship(Uri, TargetMode, String) |
이 PackagePart와 지정된 대상 PackagePart 또는 외부 리소스 간의 파트 수준 관계를 만듭니다. |
CreateRelationship(Uri, TargetMode, String, String) |
이 PackagePart와 지정된 대상 PackagePart 또는 외부 리소스 간의 파트 수준 관계를 만듭니다. |
설명
파트 수준 관계는 이 부분과 대상 부분 또는 리소스 간의 연결을 정의합니다. 부분 수준 관계는 두 가지 형식 중 하나일 수 있습니다.
내부 대상 PackagePartPackage에 대한 원본 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)
- Source:
- PackagePart.cs
- Source:
- PackagePart.cs
- Source:
- PackagePart.cs
이 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
열거형 값 중 하나입니다. 예를 들어 대상 파트가 Internal 내부에 있으면 Package이고, 대상이 External 외부의 리소스이면 Package입니다.
- relationshipType
- String
관계의 역할입니다.
반환
이 PackagePart와 대상 PackagePart 또는 외부 리소스 간의 파트 수준 관계입니다.
예외
targetUri
또는 relationshipType
가 null
인 경우
targetMode
매개 변수가 유효한 TargetMode 열거형 값이 아닌 경우
targetUri
로 식별된 파트가 관계인 경우. 관계의 대상은 다른 관계가 될 수 없습니다.
또는
targetMode
가 Internal로 지정되었지만 targetUri
가 절대적인 외부 URI인 경우
패키지가 읽기 전용인 경우. 이 경우 새 관계를 추가할 수 없습니다.
설명
파트 수준 관계는 이 부분과 대상 부분 또는 리소스 간의 연결을 정의합니다. 부분 수준 관계는 두 가지 형식 중 하나일 수 있습니다.
내부 대상 PackagePartPackage에 대한 원본 PackagePart 간.
패키지 외부의 대상 리소스에 대한 원본 PackagePart 간.
부분 관계에서 원본 부분은 관계의 "소유자"로 간주됩니다. 원본 파트가 삭제되면 파트가 소유한 모든 관계도 삭제됩니다. 관계를 만들거나 삭제하는 프로세스는 어떤 방식으로든 대상 부분 또는 리소스를 물리적으로 변경하지 않습니다.
메서드는 CreateRelationship 원본 부분이나 대상 부분 또는 리소스를 어떤 방식으로든 물리적으로 변경하지 않습니다.
관계의 대상은 다른 관계가 될 수 없습니다.
가 로 InternaltargetUri
지정된 경우 targetMode
RFC 3986 URI(Uniform Resource Identifier) 제네릭 구문 사양에 따라 형성되는 상대 URI여야 합니다. 내부 상대 URI는 "/page1.xaml" 또는 "/images/picture4.jpg"과 같은 슬래시("/") 문자로 시작하는 절대 경로 또는 ".와 같은 상대 경로일 수 있습니다. 패키지 루트("/")에 대해 기본 URI로 확인되는 /imagespicture1.jpg"입니다.
가 로 ExternaltargetUri
지정된 경우 targetMode
RFC 3986 URI(Uniform Resource Identifier) 제네릭 구문 사양에 따라 형성된 절대 또는 상대 URI일 수 있습니다. "https://www.microsoft.com/page2.xml"
는 외부 대상 리소스 "page2.xml"을 참조하는 절대 URI의 예입니다. "images/picture1.jpg"는 외부 대상 리소스 "1.jpg"을 참조하지만 패키지 자체의 URI에 대해 확인되는 상대 URI의 예입니다.
relationshipType
는 RFC 3986 URI(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)
- Open Packaging Conventions Specification
적용 대상
CreateRelationship(Uri, TargetMode, String, String)
- Source:
- PackagePart.cs
- Source:
- PackagePart.cs
- Source:
- PackagePart.cs
이 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);
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
열거형 값 중 하나입니다. 예를 들어 대상 파트가 Internal 내부에 있으면 Package이고, 대상이 External 외부의 리소스이면 Package입니다.
- relationshipType
- String
관계의 역할입니다.
- id
- String
관계의 고유 ID입니다.
반환
이 PackagePart와 대상 PackagePart 또는 외부 리소스 간의 파트 수준 관계입니다.
예외
targetUri
또는 relationshipType
가 null
인 경우
targetMode
매개 변수가 유효한 TargetMode 열거형 값이 아닌 경우
targetUri
로 식별된 파트가 관계인 경우. 관계의 대상은 다른 관계가 될 수 없습니다.
또는
targetMode
가 Internal로 지정되었지만 targetUri
가 절대적인 외부 URI인 경우
패키지가 읽기 전용인 경우. 이 경우 새 관계를 추가할 수 없습니다.
설명
파트 수준 관계는 이 부분과 대상 부분 또는 리소스 간의 연결을 정의합니다. 부분 수준 관계는 두 가지 형식 중 하나일 수 있습니다.
내부 대상 PackagePartPackage에 대한 원본 PackagePart 간.
패키지 외부의 대상 리소스에 대한 원본 PackagePart 간.
부분 관계에서 원본 부분은 관계의 "소유자"로 간주됩니다. 원본 파트가 삭제되면 파트가 소유한 모든 관계도 삭제됩니다. 관계를 만들거나 삭제하는 프로세스는 어떤 방식으로든 대상 부분 또는 리소스를 물리적으로 변경하지 않습니다.
id
는 유효한 XML 식별자여야 합니다. 형식은 id
xsd:ID이며 XML 스키마 파트 2: 데이터 형식 사양에 규정된 명명 규칙을 따라야 합니다(참조 https://www.w3.org/TR/xmlschema-2/#ID).
메서드는 CreateRelationship 원본 부분이나 대상 부분 또는 리소스를 어떤 방식으로든 물리적으로 변경하지 않습니다.
관계의 대상은 다른 관계가 될 수 없습니다.
가 로 InternaltargetUri
지정된 경우 targetMode
RFC 3986 URI(Uniform Resource Identifier) 제네릭 구문 사양에 따라 형성되는 상대 URI여야 합니다. 내부 상대 URI는 "/page1.xaml" 또는 "/images/picture4.jpg"과 같은 슬래시("/") 문자로 시작하는 절대 경로 또는 ".와 같은 상대 경로일 수 있습니다. 패키지 루트("/")에 대해 기본 URI로 확인되는 /imagespicture1.jpg"입니다.
가 로 ExternaltargetUri
지정된 경우 targetMode
RFC 3986 URI(Uniform Resource Identifier) 제네릭 구문 사양에 따라 형성된 절대 또는 상대 URI일 수 있습니다. "https://www.microsoft.com/page2.xml" 는 외부 대상 리소스 "page2.xml"을 참조하는 절대 URI의 예입니다. "images/picture1.jpg"는 외부 대상 리소스 "1.jpg"을 참조하지만 패키지 자체의 URI에 대해 확인되는 상대 URI의 예입니다.
relationshipType
는 RFC 3986 URI(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)
- Open Packaging Conventions Specification
적용 대상
.NET
피드백
https://aka.ms/ContentUserFeedback
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요.다음에 대한 사용자 의견 제출 및 보기