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 можно использовать для получения ссылки на экземпляр потока, связанный с частью.

Дополнительные сведения о частях пакета см. в разделе 1.1 спецификации Open Packaging Conventions (OPC), доступной для скачивания по адресу https://www.ecma-international.org/publications-and-standards/standards/ecma-376/.

CreatePart(Uri, String)

Исходный код:

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) новой части.

contentType

String

Тип содержимого потока данных.

Возвращаемое значение

PackagePart

Новая созданная часть.

Исключения

ArgumentNullException

Параметр partUri или contentType имеет значение null.

ArgumentException

partUri не является допустимым URI PackagePart.

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 можно использовать для получения ссылки на экземпляр потока, связанный с частью.

CompressionOption Часть — CompressionOption.NotCompressed.

Дополнительные сведения о частях пакета см. в разделе 1.1 спецификации Open Packaging Conventions (OPC), доступной для скачивания по адресу https://www.ecma-international.org/publications-and-standards/standards/ecma-376/.

Примечания для тех, кто наследует этот метод

CreatePart(Uri, String) внутренне вызывает метод производного CreatePartCore(Uri, String, CompressionOption) класса, чтобы фактически создать часть на основе физического формата, реализованного в производном классе.

См. также раздел

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

CreatePart(Uri, String, CompressionOption)

Исходный код:

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 не является действительным универсальным кодом ресурса (URI) PackagePart.

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 метод поддерживает только два compressionOption значения, NotCompressed или Normal сжатие.CreatePart Другие CompressionOption значения Maximum, Fastили SuperFast используют Normal сжатие.

CreatePart создает пустой Stream объект для новой части. Метод PackagePart.GetStream можно использовать для получения ссылки на экземпляр потока, связанный с частью.

Дополнительные сведения см. в спецификации Open Packaging Conventions (OPC), доступной для скачивания по адресу https://www.ecma-international.org/publications-and-standards/standards/ecma-376/.

Примечания для тех, кто наследует этот метод

CreatePart(Uri, String, CompressionOption) внутренне вызывает метод производного CreatePartCore(Uri, String, CompressionOption) класса, чтобы фактически создать часть на основе физического формата, реализованного в производном классе.

См. также раздел

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