Scrub references to WebRequest from examples (#8467)

* Remore reference to WebRequest in System.Net ns doc

* Scrub from Uri

* HttpListener

* HttpStatusCode

* HttpVersion

* WebProxy

* NetworkCredential

* SslStream

* Fix compilation

* Add missing projects

* Fix compilation

* Another compilation fix

* Final compilation fix

* Update snippets/cpp/VS_Snippets_Remoting/HttpVersion_Version10/CPP/httpversion_version10.cpp

Co-authored-by: Ahmet İbrahim AKSOY <[email protected]>

Co-authored-by: Ahmet İbrahim AKSOY <[email protected]>

Author: rzikm

snippets/cpp/VS_Snippets_Remoting/Classic HttpStatusCode Example/CPP/source.cpp

@@ -4,6 +4,7 @@
 
 using namespace System;
 using namespace System::Net;
+using namespace System::Net::Http;
 using namespace System::IO;
 using namespace System::Windows::Forms;
 
@@ -22,11 +23,14 @@ public ref class Form1: public Form
 
       CredentialCache^ myCache = gcnew CredentialCache;
 
-      myCache->Add( gcnew Uri( "www.contoso.com" ), "Basic", myCred );
-      myCache->Add( gcnew Uri( "app.contoso.com" ), "Basic", myCred );
+      myCache->Add( gcnew Uri( "http://www.contoso.com" ), "Basic", myCred );
+      myCache->Add( gcnew Uri( "http://app.contoso.com" ), "Basic", myCred );
 
-      WebRequest^ wr = WebRequest::Create( "www.contoso.com" );
-      wr->Credentials = myCache;
+      // HttpClient lifecycle management best practices:
+      // https://learn.microsoft.com/dotnet/fundamentals/networking/http/httpclient-guidelines#recommended-use
+      HttpClientHandler^ handler = gcnew HttpClientHandler();
+      handler->Credentials = myCache;
+      HttpClient^ client = gcnew HttpClient(handler);
       // </Snippet1>
    }
 };

snippets/cpp/VS_Snippets_Remoting/Classic NetworkCredential Example/CPP/source.cpp

@@ -8,6 +8,7 @@
 using namespace System;
 using namespace System::Data;
 using namespace System::Net;
+using namespace System::Net::Http;
 using namespace System::Windows::Forms;
 
 public ref class Form1: public Form
@@ -16,8 +17,13 @@ public ref class Form1: public Form
    void Method()
    {
       // <Snippet1>
-      Uri^ siteUri = gcnew Uri( "http://www.contoso.com/" );
-      WebRequest^ wr = WebRequest::Create( siteUri );
+      Uri^ siteUri = gcnew Uri("http://www.contoso.com/");
+
+      // HttpClient lifecycle management best practices:
+      // https://learn.microsoft.com/dotnet/fundamentals/networking/http/httpclient-guidelines#recommended-use
+      HttpClient^ client = gcnew HttpClient;
+      HttpRequestMessage^ request = gcnew HttpRequestMessage(HttpMethod::Get, siteUri);
+      HttpResponseMessage^ response = client->Send(request);
       // </Snippet1>
    }
 };

snippets/cpp/VS_Snippets_Remoting/Classic Uri Example/CPP/source.cpp

@@ -2,16 +2,21 @@
 
 using namespace System;
 using namespace System::Net;
+using namespace System::Net::Http;
 
 public ref class Sample
 {
 private:
    void sampleFunction()
    {
       // <Snippet1>
-      WebProxy^ proxyObject = gcnew WebProxy( "http://proxyserver:80/",true );
-      WebRequest^ req = WebRequest::Create( "http://www.contoso.com" );
-      req->Proxy = proxyObject;
+      WebProxy^ proxyObject = gcnew WebProxy("http://proxyserver:80/", true);
+
+      // HttpClient lifecycle management best practices:
+      // https://learn.microsoft.com/dotnet/fundamentals/networking/http/httpclient-guidelines#recommended-use
+      HttpClientHandler^ handler = gcnew HttpClientHandler();
+      handler->Proxy = proxyObject;
+      HttpClient^ client = gcnew HttpClient(handler);
       // </Snippet1>
    }
 };

snippets/cpp/VS_Snippets_Remoting/Classic WebProxy Example/CPP/source.cpp

@@ -1,46 +1,49 @@
 /*System::Net::HttpVersion::Version10
 This program demonstrates the  'Version10' field of the 'HttpVersion' Class.
-The 'ProtocolVersion'  property of 'HttpWebrequest' class identifies the Version of the Protocol being used.
-A new 'HttpWebRequest' Object* is created.
-Then the default value of 'ProtocolVersion' property is displayed to the console.
-The 'Version10' field of the 'HttpVersion' class is assigned to the 'ProtocolVersion' property of the 'HttpWebRequest' Class.
-The changed Version and the 'ProtocolVersion' of the response Object* are displayed.
+The 'Version'  property of 'HttpRequestMessage' class identifies the Version of HTTP being used.
+Then the default value of 'Version' property is displayed to the console.
+The 'Version10' field of the 'HttpVersion' class is assigned to the 'Version' property of the 'HttpRequestMessage' Class.
+The changed Version and the 'Version' of the response object are displayed.
 */
 
 #using <System.dll>
 
 using namespace System;
 using namespace System::IO;
 using namespace System::Net;
+using namespace System::Net::Http;
 
 int main()
 {
    try
    {
-// <Snippet1>
-      // Create a 'HttpWebRequest' object.
-      HttpWebRequest^ myHttpWebRequest = (HttpWebRequest^)( WebRequest::Create( "http://www.microsoft.com" ) );
-      Console::WriteLine( "\nThe 'ProtocolVersion' of the protocol before assignment is : {0}", myHttpWebRequest->ProtocolVersion );
-      // Assign Version10 to ProtocolVersion.
-      myHttpWebRequest->ProtocolVersion = HttpVersion::Version10;
-      // Assign the response Object* of 'HttpWebRequest' to a 'HttpWebResponse' variable.
-      HttpWebResponse^ myHttpWebResponse = (HttpWebResponse^)( myHttpWebRequest->GetResponse() );
-      Console::WriteLine( "\nThe 'ProtocolVersion' of the protocol after  assignment is : {0}", myHttpWebRequest->ProtocolVersion );
-      Console::WriteLine( "\nThe 'ProtocolVersion' of the response Object* is : {0}", myHttpWebResponse->ProtocolVersion );
-// </Snippet1>
-      Console::WriteLine( "\nPress 'Enter' Key to Continue.............." );
+      // <Snippet1>
+      // HttpClient lifecycle management best practices:
+      // https://learn.microsoft.com/dotnet/fundamentals/networking/http/httpclient-guidelines#recommended-use
+      HttpClient^ client = gcnew HttpClient();
+
+      HttpRequestMessage^ request = new HttpRequestMessage(HttpMethod::Get, "http://www.microsoft.com");
+      Console::WriteLine("Default HTTP request version is {0}", request.Version);
+
+      request.Version = HttpVersion.Version10;
+      Console::WriteLine("Request version after assignment is {0}", request.Version);
+
+      HttpResponseMessage^ response = client->Send(request);
+      Console::WriteLine("Response HTTP version {0}", response.Version);
+      // </Snippet1>
+      Console::WriteLine("\nPress 'Enter' Key to Continue..............");
       Console::Read();
    }
-   catch ( WebException^ e ) 
+   catch (HttpRequestException^ e)
    {
-      Console::WriteLine( "\nWebException Caught!" );
-      Console::WriteLine( "Message : {0} ", e->Message );
-      Console::WriteLine( "Source  : {0} ", e->Source );
+      Console::WriteLine("HttpRequestException Caught!");
+      Console::WriteLine("Message : {0} ", e->Message);
+      Console::WriteLine("Source  : {0} ", e->Source);
    }
-   catch ( Exception^ e ) 
+   catch (Exception^ e)
    {
-      Console::WriteLine( "\nException Caught!" );
-      Console::WriteLine( "Source  : {0}", e->Source );
-      Console::WriteLine( "Message : {0}", e->Message );
+      Console::WriteLine("Exception Caught!");
+      Console::WriteLine("Source  : {0}", e->Source);
+      Console::WriteLine("Message : {0}", e->Message);
    }
 }

snippets/cpp/VS_Snippets_Remoting/HttpVersion_Version10/CPP/httpversion_version10.cpp

@@ -1,15 +1,15 @@
 /*System.Net.HttpVersion.Version10
 This program demonstrates the  'Version10' field of the 'HttpVersion' Class.
-The 'ProtocolVersion'  property of 'HttpWebrequest' class identifies the Version of the Protocol being used.
-A new 'HttpWebRequest' object is created.
-Then the default value of 'ProtocolVersion' property is displayed to the console.
-The 'Version10' field of the 'HttpVersion' class is assigned to the 'ProtocolVersion' property of the 'HttpWebRequest' Class.
-The changed Version and the 'ProtocolVersion' of the response object are displayed.
+The 'Version'  property of 'HttpRequestMessage' class identifies the Version of HTTP being used.
+Then the default value of 'Version' property is displayed to the console.
+The 'Version10' field of the 'HttpVersion' class is assigned to the 'Version' property of the 'HttpRequestMessage' Class.
+The changed Version and the 'Version' of the response object are displayed.
 */
 
 using System;
 using System.IO;
 using System.Net;
+using System.Net.Http;
 
 class HttpVersion_Version10
 {
@@ -18,28 +18,31 @@ public static void Main()
 		try	
 		{
 // <Snippet1>
-			// Create a 'HttpWebRequest' object.
-			HttpWebRequest myHttpWebRequest=(HttpWebRequest)WebRequest.Create("http://www.microsoft.com");
-			Console.WriteLine("\nThe 'ProtocolVersion' of the protocol before assignment is :{0}",myHttpWebRequest.ProtocolVersion);
-			// Assign Version10 to ProtocolVersion.
-			myHttpWebRequest.ProtocolVersion=HttpVersion.Version10;
-			// Assign the response object of 'HttpWebRequest' to a 'HttpWebResponse' variable.
-			HttpWebResponse myHttpWebResponse=(HttpWebResponse)myHttpWebRequest.GetResponse();
-			Console.WriteLine("\nThe 'ProtocolVersion' of the protocol after  assignment is :{0}",myHttpWebRequest.ProtocolVersion);
-			Console.WriteLine("\nThe 'ProtocolVersion' of the response object is :{0}",myHttpWebResponse.ProtocolVersion);
+			// HttpClient lifecycle management best practices:
+			// https://learn.microsoft.com/dotnet/fundamentals/networking/http/httpclient-guidelines#recommended-use
+			HttpClient client = new HttpClient();
+
+			HttpRequestMessage request = new HttpRequestMessage(HttpMethod.Get, "http://www.microsoft.com");
+			Console.WriteLine("Default HTTP request version is {0}", request.Version);
+
+			request.Version = HttpVersion.Version10;
+			Console.WriteLine("Request version after assignment is {0}", request.Version);
+
+			HttpResponseMessage response = client.Send(request);
+			Console.WriteLine("Response HTTP version {0}", response.Version);
 // </Snippet1>
 			Console.WriteLine("\nPress 'Enter' Key to Continue..............");
 			Console.Read();			
 		}
-		catch(WebException e)
+		catch(HttpRequestException e)
 		{
-			Console.WriteLine("\nWebException Caught!");
+			Console.WriteLine("HttpRequestException Caught!");
 			Console.WriteLine("Message :{0} ",e.Message);
 			Console.WriteLine("Source  :{0} ",e.Source);
 		}
 		catch(Exception e)
 		{
-			Console.WriteLine("\nException Caught!");
+			Console.WriteLine("Exception Caught!");
 			Console.WriteLine("Source  :{0}" , e.Source);
 			Console.WriteLine("Message :{0}" , e.Message);
 		}

snippets/csharp/System.Net/HttpStatusCode/Overview/source.cs

@@ -0,0 +1,8 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <OutputType>Library</OutputType>
+    <TargetFrameworks>net6.0</TargetFrameworks>
+  </PropertyGroup>
+   
+</Project>

snippets/csharp/System.Net/HttpVersion/Overview/httpversion_version10.cs

@@ -1,11 +1,11 @@
 using System;
 using System.Net;
+using System.Net.Http;
 using System.IO;
-using System.Windows.Forms;
 
-public class Form1: Form
+public class Program
 {
- public void Method()
+ public static void Main(string[] args)
  {
 string SecurelyStoredUserName = "";
 string SecurelyStoredPassword = "";
@@ -16,12 +16,15 @@ public void Method()
 
 CredentialCache myCache = new CredentialCache();
 
-myCache.Add(new Uri("www.contoso.com"), "Basic", myCred);
-myCache.Add(new Uri("app.contoso.com"), "Basic", myCred);
-
-WebRequest wr = WebRequest.Create("www.contoso.com");
-wr.Credentials = myCache;
+myCache.Add(new Uri("http://www.contoso.com"), "Basic", myCred);
+myCache.Add(new Uri("http://app.contoso.com"), "Basic", myCred);
 
+// HttpClient lifecycle management best practices:
+// https://learn.microsoft.com/dotnet/fundamentals/networking/http/httpclient-guidelines#recommended-use
+HttpClient client = new HttpClient(new HttpClientHandler
+{
+	Credentials = myCache
+});
 // </Snippet1>
  }
 }

snippets/csharp/System.Net/NetworkCredential/Overview/Project.csproj

@@ -1,14 +1,21 @@
 using System;
 using System.Net;
+using System.Net.Http;
 
-public class Sample {
+public class Sample
+{
 
-    private void sampleFunction() {
-// <Snippet1>
-WebProxy proxyObject = new WebProxy("http://proxyserver:80/",true);
-WebRequest req = WebRequest.Create("http://www.contoso.com");
-req.Proxy = proxyObject;
+    private void sampleFunction()
+    {
+        // <Snippet1>
+        WebProxy proxyObject = new WebProxy("http://proxyserver:80/", true);
 
-// </Snippet1>
-        }
+        // HttpClient lifecycle management best practices:
+        // https://learn.microsoft.com/dotnet/fundamentals/networking/http/httpclient-guidelines#recommended-use
+        HttpClient client = new HttpClient(new HttpClientHandler
+        {
+            Proxy = proxyObject
+        });
+        // </Snippet1>
+    }
 }