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