Package.CreatePart Метод

Определение

Создает новую часть пакета.

Перегрузки

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
Исходный код:
Package.cs
Исходный код:
Package.cs
Исходный код:
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

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

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

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

Исключения

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

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

Часть с указанным partUri уже имеется в пакете.

Пакет не открыт (вызван метод Dispose(Boolean) или Close()).

Пакет доступен только для чтения (добавление новой части невозможно).

Примеры

В следующем примере показано, как создать новый 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) класса, чтобы фактически создать часть на основе физического формата, реализованного в производном классе.

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

Применяется к

CreatePart(Uri, String, CompressionOption)

Исходный код:
Package.cs
Исходный код:
Package.cs
Исходный код:
Package.cs
Исходный код:
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.

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

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

Исключения

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

partUri не является действительным универсальным кодом ресурса (URI) PackagePart.

Часть с указанным partUri уже имеется в пакете.

Значение compressionOption является недопустимым.

Пакет не открыт (вызван метод Dispose(Boolean) или Close()).

Пакет доступен только для чтения (добавление новой части невозможно).

Примеры

В следующем примере показано, как создать новый 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) класса, чтобы фактически создать часть на основе физического формата, реализованного в производном классе.

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

Применяется к