如何不备案建网站,wordpress分页404,大连服装网站建设,电商网站创办过程.NET Framework 提供了以下两种标准模式#xff0c;用于执行 I/O 密集型和计算密集型异步操作#xff1a; 异步编程模型 (APM)#xff0c;其中异步操作由一对 Begin/End 方法#xff08;如 FileStream.BeginRead 和Stream.EndRead#xff09;表示。 基于事件的异步模式 (….NET Framework 提供了以下两种标准模式用于执行 I/O 密集型和计算密集型异步操作 异步编程模型 (APM)其中异步操作由一对 Begin/End 方法如 FileStream.BeginRead 和Stream.EndRead表示。 基于事件的异步模式 (EAP)其中异步操作由 OperationName Async 和 OperationName Completed 方法/事件对如 WebClient.DownloadStringAsync 和 WebClient.DownloadStringCompleted表示。 EAP 是在 .NET Framework 2.0 版本中引入的。
任务并行库 (TPL) 可采用各种方法与任一异步模式协同使用。 可将 APM 和 EAP 操作作为任务向库使用者公开也可以公开 APM 模式但用 Task 对象在内部实现它们。 在这两种情况下可通过使用 Task 对象简化代码和利用以下有用的功能 在任务开始后随时以任务延续形式注册回调。 通过使用 ContinueWhenAll 和 ContinueWhenAny 方法或者 WaitAll 方法或 WaitAny 方法并列为响应 Begin_ 方法而执行的多个操作。 封装同一 Task 对象中的异步 I/O 密集型和计算密集型操作。 监视 Task 对象的状态。 使用 TaskCompletionSourceTResult 将操作状态封送处理至 Task 对象。
在任务中包装 APM 操作
System.Threading.Tasks.TaskFactory 和 System.Threading.Tasks.TaskFactoryTResult 类都提供了几个 TaskFactory.FromAsync 和 TaskFactoryTResult.FromAsync 方法的重载可以将 APM Begin/End 方法对封装在 Task 或 TaskTResult 实例中。 各种重载都可容纳任何具有零至三个输入参数的 Begin/End 方法对。
对于具有返回值在 Visual Basic 中为 Function的 End 方法的对使用 TaskFactoryTResult 中创建 TaskTResult 的方法。 对于具有返回 void在 Visual Basic 中为 Sub的 End 方法使用 TaskFactory 中创建 Task 的方法。
在极少情况下如果 Begin 方法具有三个以上参数或包含 ref 或 out 参数则提供仅封装 End 方法的其他 FromAsync 重载。
下面的示例显示了匹配 FileStream.BeginRead 和 FileStream.EndRead 方法的 FromAsync 重载的签名。 此重载采用三个输入参数如下所示。
public TaskTResult FromAsyncTArg1, TArg2, TArg3(FuncTArg1, TArg2, TArg3, AsyncCallback, object, IAsyncResult beginMethod, //BeginReadFuncIAsyncResult, TResult endMethod, //EndReadTArg1 arg1, // the byte[] bufferTArg2 arg2, // the offset in arg1 at which to start writing dataTArg3 arg3, // the maximum number of bytes to readobject state // optional state information) Public Function FromAsync(Of TArg1, TArg2, TArg3)(ByVal beginMethod As Func(Of TArg1, TArg2, TArg3, AsyncCallback, Object, IAsyncResult),ByVal endMethod As Func(Of IAsyncResult, TResult),ByVal dataBuffer As TArg1,ByVal byteOffsetToStartAt As TArg2,ByVal maxBytesToRead As TArg3,ByVal stateInfo As Object)第一个参数是匹配 FileStream.BeginRead 方法签名的 FuncT1,T2,T3,T4,T5,TResult 委托。 第二个参数使用 IAsyncResult 并返回 TResult 的 FuncT,TResult 委托。 由于 EndRead 返回一个整数因此编译器会将 TResult 类型推断为 Int32 并将任务类型推断为 Task。 最后第四个参数与 FileStream.BeginRead 方法中的参数相同 存储文件数据的缓冲区。 开始写入数据的缓冲区的偏移量。 要从文件中读取的最大数据量。 存储要传递至回调的用户定义状态数据的可选对象。
使用 ContinueWith 执行回调功能
如果需要访问文件中的数据而不仅仅访问字节数则 FromAsync 方法不能满足此操作。 请改用 Task其 Result 属性包含文件数据。 可以通过向原始任务添加延续来实现这种操作。 延续执行通常由 AsyncCallback 委托执行的任务。 先前任务完成且填充了数据缓冲区后调用此操作。 FileStream 对象应在返回前关闭。
下面的示例演示如何返回封装 FileStream 类的 BeginRead/EndRead 对的 Task。
const int MAX_FILE_SIZE 14000000;
public static Taskstring GetFileStringAsync(string path)
{FileInfo fi new FileInfo(path);byte[] data null;data new byte[fi.Length];FileStream fs new FileStream(path, FileMode.Open, FileAccess.Read, FileShare.Read, data.Length, true);//Taskint returns the number of bytes readTaskint task Taskint.Factory.FromAsync(fs.BeginRead, fs.EndRead, data, 0, data.Length, null);// It is possible to do other work here while waiting// for the antecedent task to complete.// ...// Add the continuation, which returns a Taskstring. return task.ContinueWith((antecedent) {fs.Close();// Result number of bytes read (if we need it.)if (antecedent.Result 100){return Data is too small to bother with.;}else{// If we did not receive the entire file, the end of the// data buffer will contain garbage.if (antecedent.Result data.Length)Array.Resize(ref data, antecedent.Result);// Will be returned in the Result property of the Taskstring// at some future point after the asynchronous file I/O operation completes.return new UTF8Encoding().GetString(data);}});
}Const MAX_FILE_SIZE As Integer 14000000
Shared Function GetFileStringAsync(ByVal path As String) As Task(Of String)Dim fi As New FileInfo(path)Dim data(fi.Length) As ByteDim fs As FileStream New FileStream(path, FileMode.Open, FileAccess.Read, FileShare.Read, data.Length, True) Task(Of Integer) returns the number of bytes readDim myTask As Task(Of Integer) Task(Of Integer).Factory.FromAsync(AddressOf fs.BeginRead, AddressOf fs.EndRead, data, 0, data.Length, Nothing) It is possible to do other work here while waiting for the antecedent task to complete. ... Add the continuation, which returns a Taskstring. Return myTask.ContinueWith(Function(antecedent)fs.Close()If (antecedent.Result 100) ThenReturn Data is too small to bother with.End If If we did not receive the entire file, the end of the data buffer will contain garbage.If (antecedent.Result data.Length) ThenArray.Resize(data, antecedent.Result)End If Will be returned in the Result property of the Taskstring at some future point after the asynchronous file I/O operation completes.Return New UTF8Encoding().GetString(data)End Function)End Function然后可调用此方法如下所示。
Taskstring t GetFileStringAsync(path); // Do some other work:// ...try{Console.WriteLine(t.Result.Substring(0, 500));}catch (AggregateException ae){Console.WriteLine(ae.InnerException.Message);} Dim myTask As Task(Of String) GetFileStringAsync(path) Do some other work...TryConsole.WriteLine(myTask.Result.Substring(0, 500))
Catch ex As AggregateExceptionConsole.WriteLine(ex.InnerException.Message)
End Try提供自定义状态数据
在通常的 IAsyncResult 操作中如果AsyncCallback 委托需要一些自定义状态数据则必须通过 Begin 方法中的最后一个参数将它传入以便可将数据打包到最终要传递至回调方法的 IAsyncResult 对象中。 当使用 FromAsync 方法时通常无需此操作。 如果延续知道自定义数据可直接在延续委托中捕获它。 下面的示例与以前的示例类似但延续检查此延续的用户委托可直接访问的自定义状态数据而不是检查历史任务的 Result 属性。
public Taskstring GetFileStringAsync2(string path)
{ FileInfo fi new FileInfo(path);byte[] data new byte[fi.Length]; MyCustomState state GetCustomState();FileStream fs new FileStream(path, FileMode.Open, FileAccess.Read, FileShare.Read, data.Length, true);// We still pass null for the last parameter because// the state variable is visible to the continuation delegate.Taskint task Taskint.Factory.FromAsync(fs.BeginRead, fs.EndRead, data, 0, data.Length, null);return task.ContinueWith((antecedent) {// It is safe to close the filestream now.fs.Close();// Capture custom state data directly in the user delegate.// No need to pass it through the FromAsync method.if (state.StateData.Contains(New York, New York)){return Start spreading the news!;}else{// If we did not receive the entire file, the end of the// data buffer will contain garbage.if (antecedent.Result data.Length)Array.Resize(ref data, antecedent.Result);// Will be returned in the Result property of the Taskstring// at some future point after the asynchronous file I/O operation completes.return new UTF8Encoding().GetString(data);}});
}Public Function GetFileStringAsync2(ByVal path As String) As Task(Of String)Dim fi New FileInfo(path)Dim data(fi.Length) As ByteDim state As New MyCustomState()Dim fs As New FileStream(path, FileMode.Open, FileAccess.Read, FileShare.Read, data.Length, True) We still pass null for the last parameter because the state variable is visible to the continuation delegate.Dim myTask As Task(Of Integer) Task(Of Integer).Factory.FromAsync(AddressOf fs.BeginRead, AddressOf fs.EndRead, data, 0, data.Length, Nothing)Return myTask.ContinueWith(Function(antecedent)fs.Close() Capture custom state data directly in the user delegate. No need to pass it through the FromAsync method.If (state.StateData.Contains(New York, New York)) ThenReturn Start spreading the news!End If If we did not receive the entire file, the end of the data buffer will contain garbage.If (antecedent.Result data.Length) ThenArray.Resize(data, antecedent.Result)End If/ Will be returned in the Result property of the Taskstring/ at some future point after the asynchronous file I/O operation completes.Return New UTF8Encoding().GetString(data)End Function)End Function同步多个 FromAsync 任务
当结合使用 FromAsync 方法时静态 ContinueWhenAll 和 ContinueWhenAny 方法具有更大的灵活性。 下面的示例显示如何启动多个异步 I/O 操作然后等待所有这些操作都完成后再执行延续。
public Taskstring GetMultiFileData(string[] filesToRead)
{FileStream fs;Taskstring[] tasks new Taskstring[filesToRead.Length];byte[] fileData null;for (int i 0; i filesToRead.Length; i){fileData new byte[0x1000];fs new FileStream(filesToRead[i], FileMode.Open, FileAccess.Read, FileShare.Read, fileData.Length, true);// By adding the continuation here, the // Result of each task will be a string.tasks[i] Taskint.Factory.FromAsync(fs.BeginRead, fs.EndRead, fileData, 0, fileData.Length, null).ContinueWith((antecedent) {fs.Close();// If we did not receive the entire file, the end of the// data buffer will contain garbage.if (antecedent.Result fileData.Length)Array.Resize(ref fileData, antecedent.Result);// Will be returned in the Result property of the Taskstring// at some future point after the asynchronous file I/O operation completes.return new UTF8Encoding().GetString(fileData);});}// Wait for all tasks to complete. return Taskstring.Factory.ContinueWhenAll(tasks, (data) {// Propagate all exceptions and mark all faulted tasks as observed.Task.WaitAll(data);// Combine the results from all tasks.StringBuilder sb new StringBuilder();foreach (var t in data){sb.Append(t.Result);}// Final result to be returned eventually on the calling thread.return sb.ToString();});
}Public Function GetMultiFileData(ByVal filesToRead As String()) As Task(Of String)Dim fs As FileStreamDim tasks(filesToRead.Length) As Task(Of String)Dim fileData() As Byte NothingFor i As Integer 0 To filesToRead.LengthfileData(H1000) New Byte()fs New FileStream(filesToRead(i), FileMode.Open, FileAccess.Read, FileShare.Read, fileData.Length, True) By adding the continuation here, the Result of each task will be a string.tasks(i) Task(Of Integer).Factory.FromAsync(AddressOf fs.BeginRead,AddressOf fs.EndRead,fileData,0,fileData.Length,Nothing).ContinueWith(Function(antecedent)fs.Close()If we did not receive the entire file, the end of the data buffer will contain garbage.If (antecedent.Result fileData.Length) ThenReDim Preserve fileData(antecedent.Result)End IfWill be returned in the Result property of the Taskstring at some future point after the asynchronous file I/O operation completes.Return New UTF8Encoding().GetString(fileData)End Function)NextReturn Task(Of String).Factory.ContinueWhenAll(tasks, Function(data) Propagate all exceptions and mark all faulted tasks as observed.Task.WaitAll(data) Combine the results from all tasks.Dim sb As New StringBuilder()For Each t As Task(Of String) In datasb.Append(t.Result)Next Final result to be returned eventually on the calling thread.Return sb.ToString()End Function)
End Function仅用于 End 方法的 FromAsync 任务
在极少情况下如果 Begin 方法需要三个以上的输入参数或具有 ref 或 out 参数可以使用仅表示 End 方法的 FromAsync 重载例如TaskFactoryTResult.FromAsync(IAsyncResult, FuncIAsyncResult,TResult)。 这些方法还可用于传递 IAsyncResult 并将其封装到 Task 的任何方案中。
static TaskString ReturnTaskFromAsyncResult()
{IAsyncResult ar DoSomethingAsynchronously();TaskString t Taskstring.Factory.FromAsync(ar, _ {return (string)ar.AsyncState;});return t;
}Shared Function ReturnTaskFromAsyncResult() As Task(Of String)Dim ar As IAsyncResult DoSomethingAsynchronously()Dim t As Task(Of String) Task(Of String).Factory.FromAsync(ar, Function(res) CStr(res.AsyncState))Return t
End Function启动和取消 FromAsync 任务
FromAsync 方法返回的任务具有 WaitingForActivation 状态并在创建任务后在某个时刻由操作系统启动。 如果尝试调用此类任务上的“启动”将引发异常。
无法取消 FromAsync 任务因为基础 .NET Framework API 目前不支持取消正在进行中的文件或网络 I/O。 可以将取消功能添加到封装 FromAsync 调用的方法中但只能在调用 FromAsync 之前或在调用完成之后响应取消例如在延续任务中。
一些支持 EAP 的类如 WebClient不支持取消但可以通过使用取消标记集成该本机取消功能。
将复杂的 EAP 操作公开为任务
TPL 不提供任何专用于以 FromAsync 系列方法包装 IAsyncResult 模式相同的方式封装基于事件的异步操作的方法。 但是TPL 会提供 System.Threading.Tasks.TaskCompletionSourceTResult 类此类可用于将任意一组操作表示为 TaskTResult。 这些操作可能同步、可能异步可能是 I/O 密集型、也可能是计算密集型还可能两者都是。
下面的示例显示如何使用 TaskCompletionSourceTResult 将一组异步 WebClient 操作作为基础 TaskTResult 向客户端代码公开。此方法允许输入 Web URL 数组和术语或名称来进行搜索然后返回每个站点搜索字词出现的次数。
using System;
using System.Collections.Generic;
using System.Linq;
using System.Net;
using System.Threading;
using System.Threading.Tasks;public class SimpleWebExample
{public Taskstring[] GetWordCountsSimplified(string[] urls, string name,CancellationToken token){TaskCompletionSourcestring[] tcs new TaskCompletionSourcestring[]();WebClient[] webClients new WebClient[urls.Length];object m_lock new object();int count 0;Liststring results new Liststring();// If the user cancels the CancellationToken, then we can use the// WebClients ability to cancel its own async operations.token.Register(() {foreach (var wc in webClients){if (wc ! null)wc.CancelAsync();}});for (int i 0; i urls.Length; i){webClients[i] new WebClient();#region callback// Specify the callback for the DownloadStringCompleted// event that will be raised by this WebClient instance.webClients[i].DownloadStringCompleted (obj, args) {// Argument validation and exception handling omitted for brevity.// Split the string into an array of words,// then count the number of elements that match// the search term.string[] words args.Result.Split( );string NAME name.ToUpper();int nameCount (from word in words.AsParallel()where word.ToUpper().Contains(NAME)select word).Count();// Associate the results with the url, and add new string to the array that// the underlying Task object will return in its Result property.lock (m_lock){results.Add(String.Format({0} has {1} instances of {2}, args.UserState, nameCount, name));// If this is the last async operation to complete,// then set the Result property on the underlying Task.count;if (count urls.Length){tcs.TrySetResult(results.ToArray());}}};#endregion// Call DownloadStringAsync for each URL.Uri address null;address new Uri(urls[i]);webClients[i].DownloadStringAsync(address, address);} // end for// Return the underlying Task. The client code// waits on the Result property, and handles exceptions// in the try-catch block there.return tcs.Task;}
}Imports System.Collections.Generic
Imports System.Net
Imports System.Threading
Imports System.Threading.TasksPublic Class SimpleWebExampleDim tcs As New TaskCompletionSource(Of String())Dim token As CancellationTokenDim results As New List(Of String)Dim m_lock As New Object()Dim count As IntegerDim addresses() As StringDim nameToSearch As StringPublic Function GetWordCountsSimplified(ByVal urls() As String, ByVal str As String,ByVal token As CancellationToken) As Task(Of String())addresses urlsnameToSearch strDim webClients(urls.Length - 1) As WebClient If the user cancels the CancellationToken, then we can use the WebClients ability to cancel its own async operations.token.Register(Sub()For Each wc As WebClient In webClientsIf wc IsNot Nothing Thenwc.CancelAsync()End IfNextEnd Sub)For i As Integer 0 To urls.Length - 1webClients(i) New WebClient() Specify the callback for the DownloadStringCompleted event that will be raised by this WebClient instance.AddHandler webClients(i).DownloadStringCompleted, AddressOf WebEventHandlerDim address As New Uri(urls(i)) Pass the address, and also use it for the userToken to identify the page when the delegate is invoked.webClients(i).DownloadStringAsync(address, address)Next Return the underlying Task. The client code waits on the Result property, and handles exceptions in the try-catch block there.Return tcs.TaskEnd FunctionPublic Sub WebEventHandler(ByVal sender As Object, ByVal args As DownloadStringCompletedEventArgs)If args.Cancelled True Thentcs.TrySetCanceled()ReturnElseIf args.Error IsNot Nothing Thentcs.TrySetException(args.Error)ReturnElse Split the string into an array of words, then count the number of elements that match the search term.Dim words() As String args.Result.Split( c)Dim name As String nameToSearch.ToUpper()Dim nameCount (From word In words.AsParallel()Where word.ToUpper().Contains(name)Select word).Count() Associate the results with the url, and add new string to the array that the underlying Task object will return in its Result property.SyncLock (m_lock)results.Add(String.Format({0} has {1} instances of {2}, args.UserState, nameCount, nameToSearch))count count 1If (count addresses.Length) Thentcs.TrySetResult(results.ToArray())End IfEnd SyncLockEnd IfEnd Sub
End Class有关包括其他异常处理且展示了如何通过客户端代码调用方法的更完整示例请参阅如何在任务中包装 EAP 模式。
请记住通过 TaskCompletionSourceTResult 创建的任何任务均由 TaskCompletionSource 启动因此用户代码不应在此任务中调用 Start 方法。
使用任务实现 APM 模式
在某些情况下可能需要通过使用 API 中 Begin/End 方法对直接公开 IAsyncResult 模式。 例如可能想要与现有的 API 保持一致或者可能具有需要这种模式的自动化工具。 在这种情况下可使用任务来简化在内部实现 APM 模式的方式。
下面的示例显示如何使用任务实现长时间运行计算密集型方法的 APM Begin/End 方法对。
class Calculator
{public IAsyncResult BeginCalculate(int decimalPlaces, AsyncCallback ac, object state){Console.WriteLine(Calling BeginCalculate on thread {0}, Thread.CurrentThread.ManagedThreadId);Taskstring f Taskstring.Factory.StartNew(_ Compute(decimalPlaces), state);if (ac ! null) f.ContinueWith((res) ac(f));return f;}public string Compute(int numPlaces){Console.WriteLine(Calling compute on thread {0}, Thread.CurrentThread.ManagedThreadId);// Simulating some heavy work.Thread.SpinWait(500000000);// Actual implemenation left as exercise for the reader.// Several examples are available on the Web.return 3.14159265358979323846264338327950288;}public string EndCalculate(IAsyncResult ar){Console.WriteLine(Calling EndCalculate on thread {0}, Thread.CurrentThread.ManagedThreadId);return ((Taskstring)ar).Result;}
}public class CalculatorClient
{static int decimalPlaces 12;public static void Main(){Calculator calc new Calculator();int places 35;AsyncCallback callBack new AsyncCallback(PrintResult);IAsyncResult ar calc.BeginCalculate(places, callBack, calc);// Do some work on this thread while the calulator is busy.Console.WriteLine(Working...);Thread.SpinWait(500000);Console.ReadLine();}public static void PrintResult(IAsyncResult result){Calculator c (Calculator)result.AsyncState;string piString c.EndCalculate(result);Console.WriteLine(Calling PrintResult on thread {0}; result {1},Thread.CurrentThread.ManagedThreadId, piString);}
}Class CalculatorPublic Function BeginCalculate(ByVal decimalPlaces As Integer, ByVal ac As AsyncCallback, ByVal state As Object) As IAsyncResultConsole.WriteLine(Calling BeginCalculate on thread {0}, Thread.CurrentThread.ManagedThreadId)Dim myTask Task(Of String).Factory.StartNew(Function(obj) Compute(decimalPlaces), state)myTask.ContinueWith(Sub(antedecent) ac(myTask))End FunctionPrivate Function Compute(ByVal decimalPlaces As Integer)Console.WriteLine(Calling compute on thread {0}, Thread.CurrentThread.ManagedThreadId) Simulating some heavy work.Thread.SpinWait(500000000) Actual implemenation left as exercise for the reader. Several examples are available on the Web.Return 3.14159265358979323846264338327950288End FunctionPublic Function EndCalculate(ByVal ar As IAsyncResult) As StringConsole.WriteLine(Calling EndCalculate on thread {0}, Thread.CurrentThread.ManagedThreadId)Return CType(ar, Task(Of String)).ResultEnd Function
End ClassClass CalculatorClientShared decimalPlaces As IntegerShared Sub Main()Dim calc As New CalculatorDim places As Integer 35Dim callback As New AsyncCallback(AddressOf PrintResult)Dim ar As IAsyncResult calc.BeginCalculate(places, callback, calc) Do some work on this thread while the calulator is busy.Console.WriteLine(Working...)Thread.SpinWait(500000)Console.ReadLine()End SubPublic Shared Sub PrintResult(ByVal result As IAsyncResult)Dim c As Calculator CType(result.AsyncState, Calculator)Dim piString As String c.EndCalculate(result)Console.WriteLine(Calling PrintResult on thread {0}; result {1},Thread.CurrentThread.ManagedThreadId, piString)End SubEnd Class使用 StreamExtensions 示例代码
在使用 .NET Framework 4 的并行编程示例中Streamextensions.cs 文件包含多个引用实现以将 Task 对象用于异步文件和网络 I/O。
请参阅
任务并行库 (TPL)
