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

[アーティクル]
08/09/2011

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

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

要素および属性

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

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

属性	説明
name	省略可能。この値は .NET Frameworkでは使用されません。

entryPoint には、以下の要素があります。

assemblyIdentity

必ず指定します。 assemblyIdentity の役割および属性は、「<assemblyIdentity> 要素 (ClickOnce アプリケーション)」で定義されています。

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

commandLine

必ず指定します。 entryPoint 要素の子である必要があります。子要素は持たず、次の属性があります。

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

customHostRequired

省略できます。この属性を含めると、配置には、カスタムホストの内側に配置されるコンポーネントが含まれ、スタンドアロンアプリケーションではないことを指定できます。

この要素を指定する場合、assemblyIdentity 要素と commandLine 要素は指定できません。これらの要素を指定すると、ClickOnce によって、インストール中に妥当性確認エラーが表示されます。

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

customUX

省略可能。カスタムインストーラーによってアプリケーションがインストールおよび保守されることを示します。また、[スタート] メニューエントリ、ショートカット、[プログラムの追加または削除] エントリは作成されません。

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

customUX 要素を含むアプリケーションは、InPlaceHostingManager クラスを使用してインストール操作を実行するカスタムインストーラーを用意する必要があります。この要素を使用するアプリケーションは、マニフェストや setup.exe の必須コンポーネントブートストラップをダブルクリックする方法でインストールすることはできません。カスタムインストーラーによって、[スタート] メニューエントリ、ショートカット、[プログラムの追加または削除] エントリを作成できます。カスタムインストーラーによって [プログラムの追加または削除] エントリを作成しない場合、SubscriptionIdentity プロパティが示すサブスクリプション識別子を保存し、ユーザーが UninstallCustomUXApplication メソッドを呼び出して後でアプリケーションをアンインストールできるようにする必要があります。詳細については、「チュートリアル: 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>

参照

ClickOnce アプリケーションマニフェスト

Share via