Package.CreatePart 메서드

정의

네임스페이스:

System.IO.Packaging

어셈블리:

System.IO.Packaging.dll

패키지:

System.IO.Packaging v8.0.0

새 패키지 파트를 만듭니다.

오버로드

CreatePart(Uri, String)	지정된 URI 및 콘텐츠 형식으로 압축되지 않은 새 파트를 만듭니다.
CreatePart(Uri, String, CompressionOption)	지정된 URI, 콘텐츠 형식 및 압축 옵션으로 새 파트를 만듭니다.

예제

다음 예제에서는 새 PackagePart 을 만든 다음 파트에 데이터를 저장하는 방법을 보여줍니다. 전체 샘플은 패키지 샘플 작성을 참조하세요.

// 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 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.

설명

CreatePart 는 새 파트에 대해 빈 Stream 을 초기화합니다. 메서드를 PackagePart.GetStream 사용하여 파트와 연결된 스트림 instance 대한 참조를 가져올 수 있습니다.

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

CreatePart(Uri, String)

Source:

Package.cs

지정된 URI 및 콘텐츠 형식으로 압축되지 않은 새 파트를 만듭니다.

public:
 System::IO::Packaging::PackagePart ^ CreatePart(Uri ^ partUri, System::String ^ contentType);

public System.IO.Packaging.PackagePart CreatePart (Uri partUri, string contentType);

member this.CreatePart : Uri * string -> System.IO.Packaging.PackagePart

Public Function CreatePart (partUri As Uri, contentType As String) As PackagePart

매개 변수

partUri

Uri

새 파트의 URI(Uniform Resource Identifier)입니다.

contentType

String

데이터 스트림의 콘텐츠 형식입니다.

반환

PackagePart

새로 만들어진 파트입니다.

예외

ArgumentNullException

partUri 또는 contentType가 null인 경우

ArgumentException

partUri는 유효한 PackagePart URI가 아닙니다.

InvalidOperationException

지정된 partUri의 파트가 이미 패키지에 있는 경우

ObjectDisposedException

패키지가 열려 있지 않은 경우(Dispose(Boolean) 또는 Close()가 호출된 경우)

IOException

패키지가 읽기 전용인 경우. 이 경우 새 파트를 추가할 수 없습니다.

예제

다음 예제에서는 새 PackagePart 을 만든 다음 파트에 데이터를 저장하는 방법을 보여줍니다. 전체 샘플은 패키지 샘플 작성을 참조하세요.

// 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 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.

설명

CreatePart 는 새 파트에 대해 빈 Stream 을 초기화합니다. 메서드를 PackagePart.GetStream 사용하여 파트와 연결된 스트림 instance 대한 참조를 가져올 수 있습니다.

부분은 CompressionOption 입니다 CompressionOption.NotCompressed.

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

상속자 참고

CreatePart(Uri, String) 는 파생 클래스의 CreatePartCore(Uri, String, CompressionOption) 메서드를 내부적으로 호출하여 파생 클래스에 구현된 실제 형식에 따라 파트를 실제로 만듭니다.

추가 정보

• DeletePart(Uri)
• CreatePartUri(Uri)
• GetPartUri(Uri)
• ResolvePartUri(Uri, Uri)
• ZipPackagePart

CreatePart(Uri, String, CompressionOption)

Source:

Package.cs

지정된 URI, 콘텐츠 형식 및 압축 옵션으로 새 파트를 만듭니다.

public:
 System::IO::Packaging::PackagePart ^ CreatePart(Uri ^ partUri, System::String ^ contentType, System::IO::Packaging::CompressionOption compressionOption);

public System.IO.Packaging.PackagePart CreatePart (Uri partUri, string contentType, System.IO.Packaging.CompressionOption compressionOption);

member this.CreatePart : Uri * string * System.IO.Packaging.CompressionOption -> System.IO.Packaging.PackagePart

Public Function CreatePart (partUri As Uri, contentType As String, compressionOption As CompressionOption) As PackagePart

매개 변수

partUri

Uri

새 파트의 URI입니다.

contentType

String

데이터 스트림의 콘텐츠 형식입니다.

compressionOption

CompressionOption

데이터 스트림의 압축 옵션으로 NotCompressed 또는 Normal 압축입니다.

반환

PackagePart

새로 만들어진 파트입니다.

예외

ArgumentNullException

partUri 또는 contentType가 null인 경우

ArgumentException

partUri는 유효한 PackagePart URI(Uniform Resource Identifier)가 아닙니다.

InvalidOperationException

지정된 partUri의 파트가 이미 패키지에 있는 경우

ArgumentOutOfRangeException

compressionOption 값이 올바르지 않은 경우

ObjectDisposedException

패키지가 열려 있지 않은 경우(Dispose(Boolean) 또는 Close()가 호출된 경우)

IOException

패키지가 읽기 전용인 경우. 이 경우 새 파트를 추가할 수 없습니다.

예제

다음 예제에서는 새 PackagePart 을 만든 다음 파트에 데이터를 저장하는 방법을 보여줍니다. 전체 샘플은 패키지 샘플 작성을 참조하세요.

// 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 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.

설명

기본 ZipPackage 파생 클래스의 경우 메서드는 CreatePart 두 compressionOption 값 NotCompressed 또는 Normal 압축만 지원합니다. , 또는 의 다른 CompressionOption 값은 압축을 사용합니다Normal.MaximumSuperFastFast

CreatePart 는 새 파트에 대해 빈 Stream 을 만듭니다. 메서드를 PackagePart.GetStream 사용하여 파트와 연결된 스트림 instance 대한 참조를 가져올 수 있습니다.

자세한 내용은 에서 https://www.ecma-international.org/publications-and-standards/standards/ecma-376/다운로드할 수 있는 OPC(Open Packaging Conventions) 사양을 참조하세요.

상속자 참고

CreatePart(Uri, String, CompressionOption) 는 파생 클래스의 CreatePartCore(Uri, String, CompressionOption) 메서드를 내부적으로 호출하여 파생 클래스에 구현된 실제 형식에 따라 파트를 실제로 만듭니다.

추가 정보

• DeletePart(Uri)
• CreatePartUri(Uri)
• GetPartUri(Uri)
• ResolvePartUri(Uri, Uri)
• ZipPackagePart