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 プロパティに関連するタスクの例を次の表に示します。

目的	参照項目
アプリケーションの更新を確認する	方法 : ClickOnce アプリケーションの更新の有無をチェックする
アプリケーションの更新をダウンロードする	方法 : ClickOnce アプリケーションの更新をダウンロードする

使用例

この例では、アプリケーションがネットワークから配置されたものであることを確認したうえで、更新のダウンロードとインストールを行います。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 内)

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

プロジェクトの種類	可用性
Windows アプリケーション	使用する
クラス ライブラリ	使用しない
コンソール アプリケーション	使用する
Windows コントロール ライブラリ	使用しない
Web コントロール ライブラリ	使用しない
Windows サービス	使用する
Web サイト	使用しない

アクセス許可

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

アクセス許可	説明
FileIOPermission	ファイルとフォルダへのアクセス許可を制御します。関連する列挙値 : Unrestricted。

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

参照

処理手順

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

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

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

概念

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

参照

My.Application オブジェクト

My.Application.IsNetworkDeployed プロパティ

System.Deployment.Application.ApplicationDeployment

ConsoleApplicationBase.Deployment

その他の技術情報

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