BuildManager.BuildDesignTimeOutput Method

  • [アーティクル]

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

See Also

Reference

BuildManager Interface

VSLangProj Namespace