My.Application.Deployment プロパティ

更新 : 2007 年 11 月

現在のアプリケーションの ClickOnce 配置オブジェクトを取得します。このオブジェクトは、現在の配置をプログラムから更新する機能と、ファイルのオンデマンド ダウンロードを可能にします。

' Usage
Dim value As System.Deployment.Application.ApplicationDeployment = My.Application.Deployment
' Declaration
Public ReadOnly Property Deployment As System.Deployment.Application.ApplicationDeployment

戻り値

アプリケーションの ClickOnce 配置に関する ApplicationDeployment オブジェクトを返します。

例外

例外を引き起こす可能性のある状態を次に示します。

• アプリケーションが ClickOnce アプリケーションとして配置されていない (InvalidDeploymentException)。

解説

My.Application.Deployment プロパティは、アプリケーションの ClickOnce ApplicationDeployment オブジェクトを返します。ApplicationDeployment オブジェクトは、現在の配置をプログラムから更新する機能と、ファイルのオンデマンド ダウンロードを可能にします。ClickOnce アプリケーションとその配置方法の詳細については、「ClickOnce の配置」および「ClickOnce アプリケーションの発行」を参照してください。

My.Application.Deployment プロパティにアクセスする前に、My.Application.IsNetworkDeployed プロパティを調べてください。そうしないと、アプリケーションが ClickOnce を使用して配置されていない場合は、My.Application.Deployment プロパティを読み取ろうとしたときに InvalidDeploymentException 例外が発生します。ClickOnce アプリケーションの配置の詳細については、「方法 : ClickOnce アプリケーションを発行する」を参照してください。

My.Application.Deployment プロパティの使い方の詳細については、「Visual Basic アプリケーション モデルの概要」を参照してください。

処理手順

My.Application.Deployment プロパティに関連するタスクの例を次の表に示します。

使用例

この例では、アプリケーションがネットワークから配置されたものであることを確認したうえで、更新のダウンロードとインストールを行います。Update メソッドは、アプリケーションが最新の状態であるときはアプリケーションを更新しません。更新を使用するためには、アプリケーションを再起動する必要があります。詳細については、「方法 : ClickOnce アプリケーションの更新をダウンロードする」を参照してください。

Sub UpdateApplication()
    If My.Application.IsNetworkDeployed Then
        My.Application.Deployment.Update()
    End If
End Sub

My.Application.Deployment オブジェクトを使用して更新できるのは、ClickOnce を使用して配置したアプリケーションだけです。ClickOnce アプリケーションの配置の詳細については、「方法 : ClickOnce アプリケーションを発行する」を参照してください。

必要条件

名前空間 : Microsoft.VisualBasic.ApplicationServices

クラス : ConsoleApplicationBase

アセンブリ : Visual Basic ランタイム ライブラリ (Microsoft.VisualBasic.dll 内)

プロジェクトの種類ごとの可用性

アクセス許可

次のアクセス許可が必要です。

詳細については、「コード アクセス セキュリティ」および「アクセス許可の要求」を参照してください。

参照

処理手順

方法 : ClickOnce アプリケーションの更新の有無をチェックする

方法 : ClickOnce アプリケーションの更新をダウンロードする

方法 : ClickOnce アプリケーションを発行する

概念

Visual Basic アプリケーション モデルの概要

参照

My.Application オブジェクト

My.Application.IsNetworkDeployed プロパティ

System.Deployment.Application.ApplicationDeployment

ConsoleApplicationBase.Deployment

その他の技術情報

ClickOnce アプリケーションの発行