LEADTOOLS画像ファイルサポート（Leadtools.Codecsアセンブリ）
フレームを表示
| Leadtools.Codecs名前空間 > RasterCodecsクラス > LoadAsyncメソッド :LoadAsync（ウーリ、Object）メソッド |
public RasterImage LoadAsync( Uri uri, object userState )
'Declaration
Public Overloads Function LoadAsync( _ ByVal uri As Uri, _ ByVal userState As Object _ ) As RasterImage
'Usage
Dim instance As RasterCodecs Dim uri As Uri Dim userState As Object Dim value As RasterImage value = instance.LoadAsync(uri, userState)
public RasterImage LoadAsync( Uri uri, object userState )
public: RasterImage^ LoadAsync( Uri^ uri, Object^ userState )
ファイルは、圧縮または未圧縮の、サポートされている任意の画像形式とビット数です。
このメソッドは、マルチページファイルにおけるすべてのページをロードします。それがファイルで保存されたので、結果として生じるimageはimageの同じビット/ピクセルとカラーオーダー値を持っています。
LEADTOOLSは破損したファイルをロードしようとするので、少なくとも一部のimageを参照することができます。こうした画像の場合、ロードメソッドは成功しますが、LoadStatusはエラーコードを返します。
このメソッドを呼び出す前にそのほかのロードオプションパラメーターをセットアップするにはCodecsLoadOptionsクラスを使用します。
12と16ビットグレースケールイメージのサポートは、Document／Medicalイメージングエディションのみで利用できます。
サポートされている形式については、「利用可能な画像ファイル形式一連」を参照してください。
ファイルの保存時に使用した圧縮やカラースペースとは関係なく、すべてのPDFファイルをラスターPDFの未圧縮RasterImageFormat.RasPdfとしてロードします。
LEADTOOLSは、以下のURI計画をサポートします：| 仕組み | 説明 |
|---|---|
| UriSchemeFile | URIがローカルマシンまたは一般的な命名規約（UNC）パスのディスクファイルであることを示しています。 |
| UriSchemeHttp | URIがハイパーテキストトランスファープロトコル（HTTP）を通してアクセスされることを示しています。 |
| UriSchemeHttps | URIがセキュアなハイパーテキストトランスファープロトコル（HTTPS）を通してアクセスされることを示しています。 |
| UriSchemeFtp | URIがファイル転送プロトコル（FTP）を通してアクセスされることを示しています。 |
uriがUriSchemeHttp、UriSchemeHttpsまたはUriSchemeFtpで資源をポイントするならば、このRasterCodecsは一時バッファを作成することによって反復やり方で画像データをダウンロードしようとします。このバッファのサイズは、このメソッドを呼び出す前にUriOperationBufferSizeを準備することによって決定されることができて、変更されることができます。
確実性とプロキシ設定のために、UriOperationCredentialsとUriOperationProxyを参照します。
RasterCodecsクラスは、LoadAsyncメソッドを用いて非同期でロード画像ファイルをサポートします。これらのいずれかのメソッドを呼び出すと、コーラースレッドはブロックされ、ロード状態にあるインスタンスRasterImageのでただちに返されます（RasterImage.IsLoadingをtrueに設定）。オブジェクトがロード状態にある間は、このオブジェクトのその他のプロパティは使用してはなりません。
RasterCodecsオブジェクトがimageをロードするを完了するとき、RasterImageのいろいろなプロパティは画像情報で値を入力されます、そして、データとRasterImage.IsLoadingプロパティはfalseに設定されます。
画像のロードが完了したかどうかを判断するためにRasterImage.IsLoadingプロパティをポーリングすることは避けてください。代わりに、通知を取得するために、LoadAsyncCompletedイベントに、LoadAsync操作が完了したとき、そして、任意のエラーが発生したかどうかにかかわらず、サブスクライブします。
LoadAsyncCompletedイベントデータにはLoadAsyncから返されたものと同じオブジェクトも含まれます。このためアプリケーション内にオリジナルのオブジェクトを保持しておく必要はありません。
CodecsLoadOptions.AllPagesプロパティは、画像データが複数ページを格納するならば、RasterCodecsがすべてのページかまさにその最初のページをロードしようとするかどうか制御します。単一のページをロードするために、LoadAsync（ウーリuri、int pageNumber、オブジェクトuserState）を使います。