WixOutput Class
Class that understands the standard file structure of the WiX toolset.
Methods
Section titled “Methods”| Method | Description |
|---|---|
| Create() | Creates a new file structure in memory. |
| Create(path) | Creates a new file structure on disk. |
| Create(uri, stream) | Creates a new file structure. |
| CreateDataStream() | Creates a data stream in the wixout. |
| Dispose() | Disposes of the internal state of the file structure. |
| Dispose(disposing) | Disposes of the internsl state of the file structure. |
| ExtractEmbeddedFile(embeddedId, outputPath) | Extracts an embedded file. |
| GetData() | Gets the data of the file as a string. |
| GetDataStream() | Gets a non-closing stream to the data of the file. |
| ImportDataStream(name, path) | Imports a file from disk into the output. |
| Read(path) | Loads a wixout from a path on disk. |
| Read(baseUri) | Loads a wixout from a path on disk or embedded resource in assembly. |
| Read(assembly, resourceName) | Loads a wixout from an assembly resource stream. |
| Read(uri, stream) | Reads a file structure from an open stream. |
| Reopen(writable) | Reopen the underlying archive for read-only or read-write access. |
Properties
Section titled “Properties”| Property | Description |
|---|---|
| Uri | |
WixToolset.Data.dll version 5.0.0+41e11442b2ca93e444b60213b5ae99dcbab787d8 |
Create() Method
Section titled “Create() Method”Creates a new file structure in memory.
Declaration
Section titled “Declaration”public static WixOutput Create()Return value
Section titled “Return value”WixOutput Newly created WixOutput .
Create(path) Method
Section titled “Create(path) Method”Creates a new file structure on disk.
Declaration
Section titled “Declaration”public static WixOutput Create( string path)Parameters
Section titled “Parameters”| Parameter | Type | Description |
|---|---|---|
| path | string | Path to write file structure to. |
Return value
Section titled “Return value”WixOutput Newly created WixOutput .
Create(uri, stream) Method
Section titled “Create(uri, stream) Method”Creates a new file structure.
Declaration
Section titled “Declaration”public static WixOutput Create( System.Uri uri, System.IO.Stream stream)Parameters
Section titled “Parameters”| Parameter | Type | Description |
|---|---|---|
| uri | System.Uri | |
| stream | System.IO.Stream | Stream to write the file structure to. |
Return value
Section titled “Return value”WixOutput Newly created WixOutput .
CreateDataStream() Method
Section titled “CreateDataStream() Method”Creates a data stream in the wixout.
Declaration
Section titled “Declaration”public System.IO.Stream CreateDataStream()Return value
Section titled “Return value”System.IO.Stream Stream to the data of the file.
Dispose() Method
Section titled “Dispose() Method”Disposes of the internal state of the file structure.
Declaration
Section titled “Declaration”public void Dispose()Dispose(disposing) Method
Section titled “Dispose(disposing) Method”Disposes of the internsl state of the file structure.
Declaration
Section titled “Declaration”protected void Dispose( bool disposing)Parameters
Section titled “Parameters”| Parameter | Type | Description |
|---|---|---|
| disposing | bool | True if disposing. |
ExtractEmbeddedFile(embeddedId, outputPath) Method
Section titled “ExtractEmbeddedFile(embeddedId, outputPath) Method”Extracts an embedded file.
Declaration
Section titled “Declaration”public void ExtractEmbeddedFile( string embeddedId, string outputPath)Parameters
Section titled “Parameters”| Parameter | Type | Description |
|---|---|---|
| embeddedId | string | Id to the file to extract. |
| outputPath | string | Path to write the extracted file to. |
GetData() Method
Section titled “GetData() Method”Gets the data of the file as a string.
Declaration
Section titled “Declaration”public string GetData()Return value
Section titled “Return value”string String contents data of the file.
GetDataStream() Method
Section titled “GetDataStream() Method”Gets a non-closing stream to the data of the file.
Declaration
Section titled “Declaration”public System.IO.Stream GetDataStream()Return value
Section titled “Return value”System.IO.Stream Stream to the data of the file.
ImportDataStream(name, path) Method
Section titled “ImportDataStream(name, path) Method”Imports a file from disk into the output.
Declaration
Section titled “Declaration”public void ImportDataStream( string name, string path)Parameters
Section titled “Parameters”| Parameter | Type | Description |
|---|---|---|
| name | string | Name of the stream in the output. |
| path | string | Path to file on disk to include in the output. |
Read(path) Method
Section titled “Read(path) Method”Loads a wixout from a path on disk.
Declaration
Section titled “Declaration”public static WixOutput Read( string path)Parameters
Section titled “Parameters”| Parameter | Type | Description |
|---|---|---|
| path | string | Path to wixout file saved on disk. |
Return value
Section titled “Return value”WixOutput Loaded created WixOutput .
Read(baseUri) Method
Section titled “Read(baseUri) Method”Loads a wixout from a path on disk or embedded resource in assembly.
Declaration
Section titled “Declaration”public static WixOutput Read( System.Uri baseUri)Parameters
Section titled “Parameters”| Parameter | Type | Description |
|---|---|---|
| baseUri | System.Uri | Uri with local path to wixout file saved on disk or embedded resource in assembly. |
Return value
Section titled “Return value”WixOutput Loaded created WixOutput .
Read(assembly, resourceName) Method
Section titled “Read(assembly, resourceName) Method”Loads a wixout from an assembly resource stream.
Declaration
Section titled “Declaration”public static WixOutput Read( System.Reflection.Assembly assembly, string resourceName)Parameters
Section titled “Parameters”| Parameter | Type | Description |
|---|---|---|
| assembly | System.Reflection.Assembly | |
| resourceName | string |
Return value
Section titled “Return value”WixOutput Loaded created WixOutput .
Read(uri, stream) Method
Section titled “Read(uri, stream) Method”Reads a file structure from an open stream.
Declaration
Section titled “Declaration”public static WixOutput Read( System.Uri uri, System.IO.Stream stream)Parameters
Section titled “Parameters”| Parameter | Type | Description |
|---|---|---|
| uri | System.Uri | |
| stream | System.IO.Stream | Stream to read from. |
Return value
Section titled “Return value”WixOutput Loaded created WixOutput .
Reopen(writable) Method
Section titled “Reopen(writable) Method”Reopen the underlying archive for read-only or read-write access.
Declaration
Section titled “Declaration”public void Reopen( bool writable)Parameters
Section titled “Parameters”| Parameter | Type | Description |
|---|---|---|
| writable | bool | Indicates whether the output can be modified. Defaults to false. |
Uri Property
Section titled “Uri Property”Declaration
Section titled “Declaration”public System.Uri Uri { get; set; }