/// <summary> /// Sends the specified message to an Trackback server to execute an Trackback ping request. /// This method does not block the calling thread and allows the caller to pass an object to the method that is invoked when the operation completes. /// </summary> /// <param name="message">A <see cref="TrackbackMessage"/> that represents the information needed to execute the Trackback ping request.</param> /// <param name="userToken">A user-defined object that is passed to the method invoked when the asynchronous operation completes.</param> /// <remarks> /// <para> /// To receive notification when the Trackback ping request has been sent or the operation has been cancelled, add an event handler to the <see cref="SendCompleted"/> event. /// You can cancel a <see cref="SendAsync(TrackbackMessage, Object)"/> operation by calling the <see cref="SendAsyncCancel()"/> method. /// </para> /// </remarks> /// <exception cref="ArgumentNullException">The <paramref name="message"/> is a null reference (Nothing in Visual Basic).</exception> /// <exception cref="InvalidOperationException">The <see cref="Host"/> is a <b>null</b> reference (Nothing in Visual Basic).</exception> /// <exception cref="InvalidOperationException">This <see cref="TrackbackClient"/> has a <see cref="SendAsync(TrackbackMessage, Object)"/> call in progress.</exception> //[HostProtectionAttribute(SecurityAction.LinkDemand, ExternalThreading = true)] public void SendAsync(TrackbackMessage message, Object userToken) { Guard.ArgumentNotNull(message, "message"); if (this.Host == null) { throw new InvalidOperationException(String.Format(null, "Unable to send Trackback message. The Host property has not been initialized. \n\r Message payload: {0}", message)); } else if (this.SendOperationInProgress) { throw new InvalidOperationException(String.Format(null, "Unable to send Trackback message. The TrackbackClient has a SendAsync call in progress. \n\r Message payload: {0}", message)); } this.SendOperationInProgress = true; this.AsyncSendHasBeenCancelled = false; asyncHttpWebRequest = TrackbackClient.CreateWebRequest(this.Host, this.UserAgent, message, this.UseDefaultCredentials, this.clientOptions); object[] state = new object[6] { asyncHttpWebRequest, this, this.Host, message, this.clientOptions, userToken }; IAsyncResult result = asyncHttpWebRequest.BeginGetResponse(new AsyncCallback(AsyncSendCallback), state); ThreadPool.RegisterWaitForSingleObject(result.AsyncWaitHandle, new WaitOrTimerCallback(AsyncTimeoutCallback), state, this.Timeout, true); }
public void SendAsync(TrackbackMessage message, Object userToken) { //------------------------------------------------------------ // Validate parameter //------------------------------------------------------------ Guard.ArgumentNotNull(message, "message"); //------------------------------------------------------------ // Validate client state //------------------------------------------------------------ if (this.Host == null) { throw new InvalidOperationException(String.Format(null, "Unable to send Trackback message. The Host property has not been initialized. \n\r Message payload: {0}", message)); } else if (this.SendOperationInProgress) { throw new InvalidOperationException(String.Format(null, "Unable to send Trackback message. The TrackbackClient has a SendAsync call in progress. \n\r Message payload: {0}", message)); } //------------------------------------------------------------ // Set async operation tracking indicators //------------------------------------------------------------ this.SendOperationInProgress = true; this.AsyncSendHasBeenCancelled = false; //------------------------------------------------------------ // Build Trackback web request used to send the Trackback ping request //------------------------------------------------------------ asyncHttpWebRequest = TrackbackClient.CreateWebRequest(this.Host, this.UserAgent, message, this.UseDefaultCredentials, this.clientOptions); //------------------------------------------------------------ // Get the async response to the web request //------------------------------------------------------------ object[] state = new object[6] { asyncHttpWebRequest, this, this.Host, message, this.clientOptions, userToken }; IAsyncResult result = asyncHttpWebRequest.BeginGetResponse(new AsyncCallback(AsyncSendCallback), state); //------------------------------------------------------------ // Register the timeout callback //------------------------------------------------------------ ThreadPool.RegisterWaitForSingleObject(result.AsyncWaitHandle, new WaitOrTimerCallback(AsyncTimeoutCallback), state, this.Timeout, true); }
//============================================================ // PUBLIC METHODS //============================================================ #region Send(TrackbackMessage message) /// <summary> /// Sends the specified message to a Trackback server to execute an Trackback ping request. /// </summary> /// <param name="message">A <see cref="TrackbackMessage"/> that represents the information needed to execute the Trackback ping request.</param> /// <returns>A <see cref="TrackbackResponse"/> that represents the server's response to the Trackback ping request.</returns> /// <exception cref="ArgumentNullException">The <paramref name="message"/> is a null reference (Nothing in Visual Basic).</exception> /// <exception cref="InvalidOperationException">The <see cref="Host"/> is a <b>null</b> reference (Nothing in Visual Basic).</exception> /// <exception cref="InvalidOperationException">This <see cref="TrackbackClient"/> has a <see cref="SendAsync(TrackbackMessage, Object)"/> call in progress.</exception> public TrackbackResponse Send(TrackbackMessage message) { //------------------------------------------------------------ // Local members //------------------------------------------------------------ TrackbackResponse response = null; //------------------------------------------------------------ // Validate parameter //------------------------------------------------------------ Guard.ArgumentNotNull(message, "message"); //------------------------------------------------------------ // Validate client state //------------------------------------------------------------ if (this.Host == null) { throw new InvalidOperationException(String.Format(null, "Unable to send Trackback message. The Host property has not been initialized. \n\r Message payload: {0}", message)); } else if (this.SendOperationInProgress) { throw new InvalidOperationException(String.Format(null, "Unable to send Trackback message. The TrackbackClient has a SendAsync call in progress. \n\r Message payload: {0}", message)); } //------------------------------------------------------------ // Execute the Trackback ping request //------------------------------------------------------------ WebRequest webRequest = TrackbackClient.CreateWebRequest(this.Host, this.UserAgent, message, this.UseDefaultCredentials, this.clientOptions); using (WebResponse webResponse = (WebResponse)webRequest.GetResponse()) { response = new TrackbackResponse(webResponse); } return(response); }