LoadAsyncCompleted事件

总结

指示异步加载操作已完成。

语法

c++

Java

公共事件EventHandler <CodecsLoadAsyncCompletedEventArgs> LoadAsyncCompleted

公共事件LoadAsyncCompleted作为EventHandler (CodecsLoadAsyncCompletedEventArgs)

同步公共无效addLoadAsyncCompletedListener (CodecsLoadAsyncCompletedListener侦听器)同步公共无效removeLoadAsyncCompletedListener (CodecsLoadAsyncCompletedListener侦听器)

公共：事件EventHandler < CodecsLoadAsyncCompletedEventArgs ^ > ^ LoadAsyncCompleted

事件数据

事件处理程序接收一个类型的参数CodecsLoadAsyncCompletedEventArgs包含与此事件相关的数据。以下CodecsLoadAsyncCompletedEventArgs属性提供特定于此事件的信息。

财产	描述
取消了(继承自System.ComponentModel.AsyncCompletedEventArgs）	获取一个值，该值指示异步操作是否已取消。
错误(继承自System.ComponentModel.AsyncCompletedEventArgs）	获取一个值，该值指示在异步操作期间发生的错误。
文件名(继承自Leadtools.Codecs.CodecsAsyncCompletedEventArgs）	获取此异步操作正在使用的文件名。
图像	得到了RasterImage正在加载的类实例。
流(继承自Leadtools.Codecs.CodecsAsyncCompletedEventArgs）	获取此异步操作正在使用的流。
Uri(继承自Leadtools.Codecs.CodecsAsyncCompletedEventArgs）	获取此异步操作正在使用的URI。
UserState(继承自System.ComponentModel.AsyncCompletedEventArgs）	获取异步任务的唯一标识符。

讲话

请注意:本课题是RasterCodecs使用.NET提供异步支持System.ComponentMode.AsyncOperation模型。为。net异步/等待支持此类型/成员不使用。相反，请参考RasterCodecs异步操作．

的RasterCodecs类支持异步加载图像文件LoadAsync方法。调用这些方法时，调用方线程将不会被阻塞，并且该方法将立即返回RasterImage处于加载状态(RasterImage。IsLoading设置为真正的)．当对象处于加载状态时，不应使用此对象的其他属性。

当RasterCodecs对象加载完成后，图像的各种属性RasterImage将填充图像信息和数据和RasterImage。IsLoading属性将设置为假．

建议不进行轮询RasterImage。IsLoading属性来确定图像是否已完成加载，相反，请订阅LoadAsyncCompleted事件时获取通知LoadAsync操作是否完成，是否发生错误。

的LoadAsyncCompleted事件数据也将包含返回的相同对象LoadAsync因此，您不必在应用程序中保留原始对象。

的LoadAsyncCompleted事件使用类型的数据参数对象CodecsLoadAsyncCompletedEventArgs．该类包含以下属性:

财产	描述
CodecsLoadAsyncCompletedEventArgs。Uri，CodecsLoadAsyncCompletedEventArgs。流和CodecsLoadAsyncCompletedEventArgs。文件名	包含传递给初始化此异步操作的方法的URI、流或文件名。这些属性中只有一个可以是有效值(不是零包含有效引用的属性取决于的版本LoadAsync方法已被调用。例如，如果LoadAsync(Uri，对象userState)被称为，Uri将包含传递给方法的相同URI，而流和文件名都会是零．如果LoadAsync(String fileName，对象userState)被称为，文件名将包含相同的文件名字符串值传递给方法而Uri和流都会是零等等......
CodecsLoadAsyncCompletedEventArgs。图像	包含了RasterImage类实例，其中包含正在加载的图像数据。方法返回的对象与此实例相同LoadAsync方法。的值，当异步操作正在运行时RasterImage。IsLoading将真正的指示该对象正在用图像信息填充，不应使用。当异步操作完成时，LoadAsyncCompleted事件将触发图像将包含最终和准备使用的对象。如果发生错误，此属性将被设置为零该对象由工具箱在内部进行处理。
CodecsLoadAsyncCompletedEventArgs。错误	包含在异步操作期间可能发生的任何错误。时，必须检查此值LoadAsyncCompleted事件触发，并确保它不包含有效的异常对象。
CodecsLoadAsyncCompletedEventArgs。取消了	包含一个值，该值指示异步操作是否已取消。例如，通过调用CancelAsync当使用RasterCodecs。LoadAsyncURL。

例子

使用Leadtools;使用Leadtools.Codecs;使用Leadtools.ImageProcessing;使用Leadtools.ImageProcessing.Color;使用Leadtools.Svg;公共无效LoadAsyncCompletedExample ()｛字符串srcFileName = Path.Combine(LEAD_VARS.ImagesDir，“Image1.cmp”）;Uri =新Uri (srcFileName);RasterCodecs codecs =新RasterCodecs ();//现在异步加载图像编解码器。LoadAsyncCompleted + =新EventHandler < CodecsLoadAsyncCompletedEventArgs > (LoadAsyncCompletedExample_LoadAsyncCompleted);对象rasterImageObject =编解码器。LoadAsync (uri,零）;//注意返回的rasterImageObject是一个IsLoading设置为true的RasterImage//当loadasynccompleted完成时，IsLoading将为false(因此，对象将可用)/ /火灾。｝私人无效LoadAsyncCompletedExample_LoadAsyncCompleted (对象发件人，CodecsLoadAsyncCompletedEventArgs｛如果(e.Cancelled)｛控制台。WriteLine (“用户取消了”）;｝其他的如果(e.Error ! =零）｛控制台。WriteLine (错误:“+ e.Error.Message);｝其他的｛//一切正常，获取图像RasterImage image = e.Image;控制台。WriteLine (Image at {0} loaded OK, size: {1} by {2}， e.Uri，图像。宽度,image.Height);image.Dispose ();｝//取消订阅事件并释放RasterCodecs对象RasterCodecs codecs =发送者作为RasterCodecs;编解码器。LoadAsyncCompleted - =新EventHandler < CodecsLoadAsyncCompletedEventArgs > (LoadAsyncCompletedExample_LoadAsyncCompleted);codecs.Dispose ();｝静态类LEAD_VARS｛公共常量字符串ImagesDir =@“C: \ LEADTOOLS21 \ Resources \图片”；｝

需求

目标平台

另请参阅

参考

RasterCodecs类

RasterCodecs成员

下载我们的免费评估

帮助版本21.0.2021.7.2