<entryPoint> 要素 (ClickOnce アプリケーション)

この ClickOnce アプリケーションをクライアント コンピューターで実行するときに実行するアセンブリを識別します。

構文

<entryPoint
   name
>
   <assemblyIdentity
      name
      version
      processorArchitecture
      language
   />
   <commandLine
      file
      parameters
   />
   <customHostRequired />
   <customUX />
</entryPoint>

要素と属性

entryPoint要素は必須であり、urn:schemas-microsoft-com:asm.v2名前空間にあります。 アプリケーション マニフェストで定義できる entryPoint 要素は 1 つだけです。

entryPoint要素には、次の属性があります。

特性 Description
name Optional. この値は、.NET Framework では使用されません。

entryPoint には次の要素があります。

assemblyIdentity

Required. assemblyIdentityとその属性のロールは、<assemblyIdentity> 要素で定義されます。

この要素のprocessorArchitecture属性と、アプリケーション マニフェストの他の場所にあるassemblyIdentityで定義されているprocessorArchitecture属性が一致している必要があります。

コマンドライン

Required. entryPoint要素の子である必要があります。 子要素がなく、次の属性があります。

特性 Description
file Required. ClickOnce アプリケーションのスタートアップ アセンブリへのローカル参照。 この値には、スラッシュ (/) または円記号 (\) のパス区切り記号を含めることはできません。
parameters Required. エントリ ポイントで実行するアクションについて説明します。 有効な値は runだけです。空白の文字列が指定されている場合は、 run が想定されます。

customHostRequired

Optional. 含まれている場合は、このデプロイにカスタム ホスト内にデプロイされるコンポーネントが含まれており、スタンドアロン アプリケーションではないことを指定します。

この要素が存在する場合、 assemblyIdentity 要素と commandLine 要素も存在してはなりません。 その場合、ClickOnce はインストール中に検証エラーを発生させます。

この要素には属性がなく、子もありません。

customUX

Optional. アプリケーションがカスタム インストーラーによってインストールおよび管理され、[スタート] メニューエントリ、ショートカット、または [プログラムの追加と削除] エントリを作成しないことを指定します。

<customUX xmlns="urn:schemas-microsoft-com:clickonce.v1" />

customUX 要素を含むアプリケーションは、 <xref:System.Deployment.Application.InPlaceHostingManager> クラスを使用してインストール操作を実行するカスタム インストーラーを提供する必要があります。 この要素を持つアプリケーションは、そのマニフェストをダブルクリックするか、前提条件のブートストラップ setup.exe インストールできません。 カスタム インストーラーでは、[スタート] メニューのエントリ、ショートカット、および [プログラムの追加と削除] エントリを作成できます。 カスタム インストーラーで [プログラムの追加と削除] エントリが作成されない場合は、 <xref:System.Deployment.Application.GetManifestCompletedEventArgs.SubscriptionIdentity%2A> プロパティによって提供されるサブスクリプション識別子を格納し、ユーザーが後で <xref:System.Deployment.Application.InPlaceHostingManager.UninstallCustomUXApplication%2A> メソッドを呼び出してアプリケーションをアンインストールできるようにする必要があります。 詳細については、「 チュートリアル: ClickOnce アプリケーションのカスタム インストーラーを作成する」を参照してください。

解説

この要素は、ClickOnce アプリケーションのアセンブリとエントリ ポイントを識別します。

commandLineを使用して、実行時にアプリケーションにパラメーターを渡すことはできません。 ClickOnce 配置のクエリ文字列パラメーターには、アプリケーションの AppDomainからアクセスできます。 詳細については、「 方法: オンライン ClickOnce アプリケーションでクエリ文字列情報を取得する」を参照してください。

次のコード例は、ClickOnce アプリケーションのアプリケーション マニフェスト内の entryPoint 要素を示しています。 このコード例は、 ClickOnce アプリケーション マニフェスト トピックで提供されるより大きな例の一部です。

<!-- Identify the main code entrypoint. -->
<!-- This code runs the main method in an executable assembly. -->
  <entryPoint>
    <assemblyIdentity
      name="MyApplication"
      version="1.0.0.0"
      language="neutral"
      processorArchitecture="x86" />
    <commandLine file="MyApplication.exe" parameters="" />
  </entryPoint>

こちらも参照ください