GenerateApplicationManifest 类

定义

生成 ClickOnce 项目的应用程序清单。Generates an application manifest for ClickOnce projects.

此 API 支持产品基础结构,不能在代码中直接使用。

public ref class GenerateApplicationManifest sealed : Microsoft::Build::Tasks::GenerateManifestBase
public sealed class GenerateApplicationManifest : Microsoft.Build.Tasks.GenerateManifestBase
type GenerateApplicationManifest = class
    inherit GenerateManifestBase
Public NotInheritable Class GenerateApplicationManifest
Inherits GenerateManifestBase
继承
GenerateApplicationManifest

注解

EntryPoint是一个可选 ITaskItem [] 参数,指示生成的清单程序集的入口点。EntryPoint is an optional ITaskItem[] parameter that indicates the entry point for the generated manifest assembly. 对于 ClickOnceClickOnce 部署清单,此输入指定了 ClickOnceClickOnce 应用程序清单。For a ClickOnceClickOnce deployment manifest, this input specifies the ClickOnceClickOnce application manifest.

在中 Visual Studio 2005Visual Studio 2005GenerateApplicationManifest 任务 需要在 EntryPoint 生成应用程序清单时使用。In Visual Studio 2005Visual Studio 2005, the GenerateApplicationManifest Task requires an EntryPoint when an application manifest is generated. (程序集或本机清单不需要 EntryPoint 。 ) 此要求由生成错误 "MSB3185:未指定清单的入口点" 强制执行。(Assembly or native manifests do not require an EntryPoint.) This requirement is enforced by the build error "MSB3185: EntryPoint not specified for manifest."

在中 Visual Studio 2008Visual Studio 2008MSBuildMSBuild 如果 EntryPoint 未指定任务参数,则不会发出此错误。In Visual Studio 2008Visual Studio 2008, MSBuildMSBuild does not issue this error when the EntryPoint task parameter is not specified. 相反,此 <customHostSpecified> 标记将插入为标记的子元素, <entryPoint> 例如,如下所示。Instead, the <customHostSpecified> tag is inserted as a child of the <entryPoint> tag, for example, as follows.

<entryPoint xmlns="urn:schemas-
  microsoft-com:asm.v2">
    <co.v1:customHostSpecified />
</entryPoint>

通过执行以下步骤,可将 DDL 依赖项添加到应用程序清单:You can add DLL dependencies to the application manifest by using the following steps:

  1. 使用对的调用解析程序集中的引用 ResolveAssemblyReferenceResolve the references in the assembly by using a call to ResolveAssemblyReference.

  2. 将上一个任务的输出和程序集本身传递给 ResolveManifestFilesPass the output of the previous task and the assembly itself to ResolveManifestFiles.

  3. 使用 Dependencies 参数将依赖项传递给 GenerateApplicationManifestPass the dependencies by using the Dependencies parameter to GenerateApplicationManifest.

构造函数

GenerateApplicationManifest()

此 API 支持产品基础结构,不能在代码中直接使用。

初始化 GenerateApplicationManifest 类的新实例。Initializes a new instance of the GenerateApplicationManifest class.

属性

AssemblyName

此 API 支持产品基础结构,不能在代码中直接使用。

获取或设置程序集的名称。Gets or sets the name of the assembly.

(继承自 GenerateManifestBase)
AssemblyVersion

此 API 支持产品基础结构,不能在代码中直接使用。

获取或设置程序集版本。Gets or sets the assembly version.

(继承自 GenerateManifestBase)
BuildEngine

生成引擎自动设置此属性,以允许任务回调到其中。The build engine automatically sets this property to allow tasks to call back into it.

(继承自 Task)
BuildEngine2

生成引擎自动设置此属性,以允许任务回调到其中。The build engine automatically sets this property to allow tasks to call back into it. 这是一个便捷属性,因此从此类继承的任务作者不必将值从 IBuildEngine 强制转换为 IBuildEngine2。This is a convenience property so that task authors inheriting from this class do not have to cast the value from IBuildEngine to IBuildEngine2.

(继承自 Task)
BuildEngine3

检索主机提供的生成引擎接口的 IBuildEngine3 版本。Retrieves the IBuildEngine3 version of the build engine interface provided by the host.

(继承自 Task)
BuildEngine4

检索主机提供的生成引擎接口的 IBuildEngine4 版本。Retrieves the IBuildEngine4 version of the build engine interface provided by the host.

(继承自 Task)
BuildEngine5

检索主机提供的生成引擎接口的 IBuildEngine5 版本。Retrieves the IBuildEngine5 version of the build engine interface provided by the host.

(继承自 Task)
BuildEngine6

检索主机提供的生成引擎接口的 IBuildEngine6 版本。Retrieves the IBuildEngine6 version of the build engine interface provided by the host.

(继承自 Task)
BuildEngine7

获取主机提供的生成引擎接口的版本。Gets the version of the build engine interface provided by the host.

(继承自 Task)
ClrVersion

此 API 支持产品基础结构,不能在代码中直接使用。

获取或设置应用程序需要的公共语言运行时 (CLR) 的最低版本。Gets or sets the minimum version of the Common Language Runtime (CLR) required by the application.

ConfigFile

此 API 支持产品基础结构,不能在代码中直接使用。

获取或设置包含应用程序配置文件的任务项。Gets or sets the task item that contains the application configuration file.

Dependencies

此 API 支持产品基础结构,不能在代码中直接使用。

获取或设置为生成的清单定义依赖程序集集合的项列表。Gets or sets an item list that defines the set of dependent assemblies for the generated manifest.

Description

此 API 支持产品基础结构,不能在代码中直接使用。

获取或设置清单说明文本。Gets or sets the manifest description text.

(继承自 GenerateManifestBase)
EntryPoint

此 API 支持产品基础结构,不能在代码中直接使用。

获取或设置作为清单入口点的托管程序集或 ClickOnce 清单引用。Gets or sets the managed assembly or ClickOnce manifest reference that is the entry point to the manifest.

(继承自 GenerateManifestBase)
ErrorReportUrl

此 API 支持产品基础结构,不能在代码中直接使用。

获取或设置在 ClickOnce 安装期间对话框中显示的网页的 URL。Gets or sets the URL of the Web page that is displayed in dialog boxes during ClickOnce installations.

FileAssociations

此 API 支持产品基础结构,不能在代码中直接使用。

获取或设置与 ClickOnce 部署清单关联的一个或多个文件类型的列表。Gets or sets a list of one or more file type that are associated with the ClickOnce deployment manifest. 文件关联只在面向 .NET Framework.NET Framework 3.5 或更高版本时才有效。File associations only valid only when .NET Framework.NET Framework 3.5 or later is targeted.

Files

此 API 支持产品基础结构,不能在代码中直接使用。

获取或设置要包括在清单中的文件的完整路径。Gets or sets the full paths of files to include in the manifest.

HelpKeywordPrefix

获取或设置前缀,该前缀用于通过字符串资源名称组成 help 关键字。Gets or sets the prefix used to compose help keywords from string resource names. 如果任务没有与消息关联的 help 关键字,则可以忽略此属性或将其设置为 null。If a task does not have help keywords associated with its messages, it can ignore this property or set it to null. 如果前缀设置为空字符串,则字符串资源名称将逐字用作 help 关键字。If the prefix is set to an empty string, then string resource names will be used verbatim as help keywords. 有关如何使用此前缀的示例,请参阅 TaskLoggingHelper.LogErrorWithCodeFromResources(string, object[]) 方法。For an example of how this prefix is used, see the TaskLoggingHelper.LogErrorWithCodeFromResources(string, object[]) method.

(继承自 Task)
HostInBrowser

此 API 支持产品基础结构,不能在代码中直接使用。

获取或设置应用程序是否承载于在浏览器中(与 WPF Web 浏览器应用程序一样)。Gets or sets whether the application is hosted in a browser (as are WPF Web Browser Applications).

HostObject

如果主机 IDE 具有与此特定任务关联的主机对象,则生成引擎会设置此属性。The build engine sets this property if the host IDE has associated a host object with this particular task.

(继承自 Task)
IconFile

此 API 支持产品基础结构,不能在代码中直接使用。

获取或设置应用程序的图标文件。Gets or sets the application's icon file.

InputManifest

此 API 支持产品基础结构,不能在代码中直接使用。

获取或设置输入清单。Gets or sets the input manifest.

(继承自 GenerateManifestBase)
IsolatedComReferences

此 API 支持产品基础结构,不能在代码中直接使用。

获取或设置要在生成清单中隔离的 COM 组件。Gets or sets COM components to isolate in the generated manifest.

Log

获取包含任务记录方法的 TaskLoggingHelper 类的实例。Gets an instance of a TaskLoggingHelper class containing task logging methods. taskLoggingHelper 是一个 MarshallByRef 对象,如果父任务正在创建 appdomain 并将该对象封送到其中,则该对象需要调用 MarkAsInactive。The taskLoggingHelper is a MarshallByRef object which needs to have MarkAsInactive called if the parent task is making the appdomain and marshaling this object into it. 如果在任务执行结束时未卸载 appdomain,并且未调用 MarkAsInactive 方法,则将导致在其中创建任务的 appdomain 中的任务实例泄漏。If the appdomain is not unloaded at the end of the task execution and the MarkAsInactive method is not called this will result in a leak of the task instances in the appdomain the task was created within.

(继承自 Task)
ManifestType

此 API 支持产品基础结构,不能在代码中直接使用。

获取或设置要生成的清单类型。Gets or sets the type of manifest to generate.

MaxTargetPath

此 API 支持产品基础结构,不能在代码中直接使用。

获取或设置清单文件名最大长度。Gets or sets the maximum manifest file name length.

(继承自 GenerateManifestBase)
OSVersion

此 API 支持产品基础结构,不能在代码中直接使用。

获取或设置应用程序所要求的操作系统 (OS) 的最低版本。Gets or sets the operating system (OS) version that is the minimum required by the application.

OutputManifest

此 API 支持产品基础结构,不能在代码中直接使用。

获取或设置所生成的清单。Gets or sets the generated manifest.

(继承自 GenerateManifestBase)
Platform

此 API 支持产品基础结构,不能在代码中直接使用。

获取或设置清单平台。Gets or sets the manifest platform.

(继承自 GenerateManifestBase)
Product

此 API 支持产品基础结构,不能在代码中直接使用。

指定项目文件中的 ProductName 属性。Specifies the ProductName property in the project file.

Publisher

此 API 支持产品基础结构,不能在代码中直接使用。

指定项目文件中的 PublisherName 属性。Specifies the PublisherName property in the project file.

RequiresMinimumFramework35SP1

此 API 支持产品基础结构,不能在代码中直接使用。

获取或设置应用程序是否需要 .NET Framework 3.5 SP1。Gets or sets whether the application requires the .NET Framework 3.5 SP1.

SuiteName

此 API 支持产品基础结构,不能在代码中直接使用。

获取或设置在完成 ClickOnce 部署后,“开始”菜单上应用程序所在文件夹的名称****。Gets or sets the name of the folder on the Start menu where the application is located after ClickOnce deployment.

SupportUrl

此 API 支持产品基础结构,不能在代码中直接使用。

指定项目文件中的 SupportUrl 属性。Specifies the SupportUrl property in the project file.

TargetCulture

此 API 支持产品基础结构,不能在代码中直接使用。

获取或设置清单目标区域性代码。Gets or sets the manifest target culture code.

(继承自 GenerateManifestBase)
TargetFrameworkMoniker

此 API 支持产品基础结构,不能在代码中直接使用。

获取或设置目标框架名字对象。Gets or sets the target framework moniker.

(继承自 GenerateManifestBase)
TargetFrameworkProfile

此 API 支持产品基础结构,不能在代码中直接使用。

获取或设置目标框架配置文件。Gets or sets the target framework profile.

TargetFrameworkSubset

此 API 支持产品基础结构,不能在代码中直接使用。

获取或设置要针对的 .NET Framework.NET Framework 子集的名称。Gets or sets the name of the .NET Framework.NET Framework subset to target.

TargetFrameworkVersion

此 API 支持产品基础结构,不能在代码中直接使用。

项目的目标 .NET Framework.NET Framework 版本。The target .NET Framework.NET Framework version for the project.

(继承自 GenerateManifestBase)
TaskResources

获取或设置任务的区域性特定资源。Gets or sets the task's culture-specific resources. 派生类应在构造期间注册资源,如果它们有本地化字符串,则可以通过此属性注册。Derived classes should register their resources either during construction, or via this property, if they have localized strings.

(继承自 Task)
TrustInfoFile

此 API 支持产品基础结构,不能在代码中直接使用。

获取或设置指定应用程序安全性的 XML 文档。Gets or sets an XML document that specifies the application security.

UseApplicationTrust

此 API 支持产品基础结构,不能在代码中直接使用。

指定是否将 ProductPublisherSupportUrl 属性写入到应用程序清单中。Specifies whether the Product, Publisher, and SupportUrl properties are written to the application manifest.

方法

AddAssemblyFromItem(ITaskItem)

此 API 支持产品基础结构,不能在代码中直接使用。

基于指定的项,将程序集引用添加到清单。Adds an assembly reference to the manifest, based on the specified item.

(继承自 GenerateManifestBase)
AddAssemblyNameFromItem(ITaskItem, AssemblyReferenceType)

此 API 支持产品基础结构,不能在代码中直接使用。

根据指定项和程序集引用类型,向清单添加程序集引用。Adds an assembly reference to the manifest, based on the specified item and the assembly reference type.

(继承自 GenerateManifestBase)
AddEntryPointFromItem(ITaskItem, AssemblyReferenceType)

此 API 支持产品基础结构,不能在代码中直接使用。

根据指定项和程序集引用类型,向清单添加入口点引用。Adds an entry point reference to the manifest, based on the specified item and the assembly reference type.

(继承自 GenerateManifestBase)
AddFileFromItem(ITaskItem)

此 API 支持产品基础结构,不能在代码中直接使用。

基于指定项向清单中添加文件引用。Adds a file reference to the manifest, based on the specified item.

(继承自 GenerateManifestBase)
CompareFrameworkVersions(String, String)

此 API 支持产品基础结构,不能在代码中直接使用。

比较两个 .NET Framework 版本,并确定哪个版本先于另一个版本。Compares two .NET Framework versions and determines which version comes before the other one.

(继承自 GenerateManifestBase)
ConvertFrameworkVersionToString(String)

此 API 支持产品基础结构,不能在代码中直接使用。

将给定 .NET Framework 版本转换为字符串。Converts the given .NET Framework version to a string.

(继承自 GenerateManifestBase)
Equals(Object)

确定指定对象是否等于当前对象。Determines whether the specified object is equal to the current object.

(继承自 Object)
Execute()

此 API 支持产品基础结构,不能在代码中直接使用。

执行 GenerateManifestBase 任务。Executes the GenerateManifestBase task.

(继承自 GenerateManifestBase)
FindFileFromItem(ITaskItem)

此 API 支持产品基础结构,不能在代码中直接使用。

返回与指定项匹配的清单文件引用。Returns the manifest file reference that matches the specified item.

(继承自 GenerateManifestBase)
GetHashCode()

作为默认哈希函数。Serves as the default hash function.

(继承自 Object)
GetObjectType()

此 API 支持产品基础结构,不能在代码中直接使用。

在派生类中实现时,返回清单的类型。When implemented in a derived class, returns the type of the manifest.

(继承自 GenerateManifestBase)
GetType()

获取当前实例的 TypeGets the Type of the current instance.

(继承自 Object)
MemberwiseClone()

创建当前 Object 的浅表副本。Creates a shallow copy of the current Object.

(继承自 Object)
OnManifestLoaded(Manifest)

此 API 支持产品基础结构,不能在代码中直接使用。

当在派生类中实现时,设置清单属性和所有依赖项。When implemented in a derived class, sets manifest properties and any dependencies.

(继承自 GenerateManifestBase)
OnManifestResolved(Manifest)

此 API 支持产品基础结构,不能在代码中直接使用。

在派生类中实现时,设置已解析的清单属性。When implemented in a derived class, sets resolved manifest properties.

(继承自 GenerateManifestBase)
ToString()

返回表示当前对象的字符串。Returns a string that represents the current object.

(继承自 Object)
ValidateInputs()

此 API 支持产品基础结构,不能在代码中直接使用。

验证 GenerateManifestBase 任务的输入。Validates the inputs of the GenerateManifestBase task.

(继承自 GenerateManifestBase)
ValidateOutput()

此 API 支持产品基础结构,不能在代码中直接使用。

验证生成的清单。Validates the generated manifest.

(继承自 GenerateManifestBase)

适用于