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

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

Часть с указанным параметром 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 метод поддерживает только два CreatePart значения compressionOption или NotCompressed сжатие.Normal Другие CompressionOption значения , Maximumили FastSuperFast используйте 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) , чтобы фактически создать часть на основе физического формата, реализованного в производном классе.

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

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