BuildManager.BuildDesignTimeOutput Method

Article
04/30/2015

Builds a temporary portable executable (PE) and returns its description in an XML string.

Namespace: VSLangProj
Assembly: VSLangProj (in VSLangProj.dll)

Syntax

'Declaration
Function BuildDesignTimeOutput ( _
    bstrOutputMoniker As String _
) As String

string BuildDesignTimeOutput(
    string bstrOutputMoniker
)

String^ BuildDesignTimeOutput(
    [InAttribute] String^ bstrOutputMoniker
)

abstract BuildDesignTimeOutput : 
        bstrOutputMoniker:string -> string

function BuildDesignTimeOutput(
    bstrOutputMoniker : String
) : String

Parameters

bstrOutputMoniker
Type: String

Required. Moniker string for the temporary PE to build. The moniker string must be one of the strings returned by the DesignTimeOutputMonikers property.

Return Value

Type: String
The XML description of the portable executable follows this format, shown for a custom tool output file named DataSchema.cs:

<root>
  <Application private_binpath = "AbsoluteTemporaryOutputPath"/>
  <Assembly
    codebase = "DataSchema.cs.dll"
    name = "DataSchema.cs"
    version = "0.0.0.0"
    snapshot_id = "0"
    replaceable = "True"
  />
</root>

The attributes are described below.

Attribute	Description
private_binpath	The full path of the directory that contains the temporary PE. This path is combined with the codebase attribute to create the full path to the temporary PE assembly.
codebase	The path and file name of the temporary PE relative to the private_binpath.
name	The .NET Framework simple name of the assembly being generated.
version	The major, minor, build, and revision version numbers. The value is always "0.0.0.0".
snapshot_id	An integer that is incremented each time the PE is recompiled.
replaceable	Indicates whether the project system can replace the assembly, and whether a designer should not hold a write lock on the file. Is always set to true.

Remarks

The XML string returned by this method specifies the temporary PE file. A designer instantiates the types by loading them from the PE file.

Examples

See BuildManager.

.NET Framework Security

Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.