Leadtools.Codecs Namespace > RasterCodecs Class : UseAsync Method |
The RasterCodecs object supports getting information and loading image files asynchronously through the use of the GetInformationAsync(String,Boolean,Int32,Object) and LoadAsync(String,LeadRect,Int32,CodecsLoadByteOrder,Int32,Int32,Object) methods. These methods will use an internal System.Net.WebClient object to perform their operations and this object will be created automatically on the first call to these methods and can be accessed through the AsyncWebClient property.
If it is desired to create the System.Net.WebClient object manually (for example, to subscribe to any of its event or set the credentials prior to invoking any read operations), you can call UseAsync to create the object, change its behavior and then call GetInformationAsync(String,Boolean,Int32,Object) or LoadAsync(String,LeadRect,Int32,CodecsLoadByteOrder,Int32,Int32,Object).
Note:UseAsync, AsyncWebClient, IsAsyncBusy, and CancelAsync are only applicable when the GetInformationAsync(String,Boolean,Int32,Object) or LoadAsync(String,LeadRect,Int32,CodecsLoadByteOrder,Int32,Int32,Object) was with the versions that take a System.Uri parameter. The versions that take a System.String or a System.IO.Stream does not use a System.Net.WebClient object internally. If you want to check the progress or cancel the operation then use the LoadImage event as normal.
Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2