UserAgentValue arch board feedback (Azure#27364)

christothes · web-flow · commit 0915f13ddbf7 · 2022-03-08T01:44:59.000Z
* API for setting a dynamic UserAgent string
diff --git a/sdk/core/Azure.Core/api/Azure.Core.net461.cs b/sdk/core/Azure.Core/api/Azure.Core.net461.cs
@@ -652,6 +652,14 @@ public StatusCodeClassifier(System.ReadOnlySpan<ushort> successStatusCodes) { }
         public override bool IsErrorResponse(Azure.Core.HttpMessage message) { throw null; }
     }
     public delegate System.Threading.Tasks.Task SyncAsyncEventHandler<T>(T e) where T : Azure.SyncAsyncEventArgs;
+    public partial class TelemetryDetails
+    {
+        public TelemetryDetails(System.Reflection.Assembly assembly, string? applicationId = null) { }
+        public string? ApplicationId { get { throw null; } }
+        public System.Reflection.Assembly Assembly { get { throw null; } }
+        public void Apply(Azure.Core.HttpMessage message) { }
+        public override string ToString() { throw null; }
+    }
     public abstract partial class TokenCredential
     {
         protected TokenCredential() { }
@@ -902,10 +910,6 @@ public void Dispose() { }
         public override void Process(Azure.Core.HttpMessage message) { }
         public override System.Threading.Tasks.ValueTask ProcessAsync(Azure.Core.HttpMessage message) { throw null; }
     }
-    public static partial class HttpMessageExtensions
-    {
-        public static void SetUserAgentString(this Azure.Core.HttpMessage message, Azure.Core.Pipeline.UserAgentValue userAgentValue) { }
-    }
     public partial class HttpPipeline
     {
         public HttpPipeline(Azure.Core.Pipeline.HttpPipelineTransport transport, Azure.Core.Pipeline.HttpPipelinePolicy[]? policies = null, Azure.Core.ResponseClassifier? responseClassifier = null) { }
@@ -962,12 +966,6 @@ public ServerCertificateCustomValidationArgs(System.Security.Cryptography.X509Ce
         public System.Security.Cryptography.X509Certificates.X509Chain? CertificateAuthorityChain { get { throw null; } }
         public System.Net.Security.SslPolicyErrors SslPolicyErrors { get { throw null; } }
     }
-    public partial class UserAgentValue
-    {
-        public UserAgentValue(System.Type type, string? applicationId = null) { }
-        public static Azure.Core.Pipeline.UserAgentValue FromType<T>(string? applicationId = null) { throw null; }
-        public override string ToString() { throw null; }
-    }
 }
 namespace Azure.Core.Serialization
 {
diff --git a/sdk/core/Azure.Core/api/Azure.Core.net5.0.cs b/sdk/core/Azure.Core/api/Azure.Core.net5.0.cs
@@ -652,6 +652,14 @@ public StatusCodeClassifier(System.ReadOnlySpan<ushort> successStatusCodes) { }
         public override bool IsErrorResponse(Azure.Core.HttpMessage message) { throw null; }
     }
     public delegate System.Threading.Tasks.Task SyncAsyncEventHandler<T>(T e) where T : Azure.SyncAsyncEventArgs;
+    public partial class TelemetryDetails
+    {
+        public TelemetryDetails(System.Reflection.Assembly assembly, string? applicationId = null) { }
+        public string? ApplicationId { get { throw null; } }
+        public System.Reflection.Assembly Assembly { get { throw null; } }
+        public void Apply(Azure.Core.HttpMessage message) { }
+        public override string ToString() { throw null; }
+    }
     public abstract partial class TokenCredential
     {
         protected TokenCredential() { }
@@ -902,10 +910,6 @@ public void Dispose() { }
         public override void Process(Azure.Core.HttpMessage message) { }
         public override System.Threading.Tasks.ValueTask ProcessAsync(Azure.Core.HttpMessage message) { throw null; }
     }
-    public static partial class HttpMessageExtensions
-    {
-        public static void SetUserAgentString(this Azure.Core.HttpMessage message, Azure.Core.Pipeline.UserAgentValue userAgentValue) { }
-    }
     public partial class HttpPipeline
     {
         public HttpPipeline(Azure.Core.Pipeline.HttpPipelineTransport transport, Azure.Core.Pipeline.HttpPipelinePolicy[]? policies = null, Azure.Core.ResponseClassifier? responseClassifier = null) { }
@@ -962,12 +966,6 @@ public ServerCertificateCustomValidationArgs(System.Security.Cryptography.X509Ce
         public System.Security.Cryptography.X509Certificates.X509Chain? CertificateAuthorityChain { get { throw null; } }
         public System.Net.Security.SslPolicyErrors SslPolicyErrors { get { throw null; } }
     }
-    public partial class UserAgentValue
-    {
-        public UserAgentValue(System.Type type, string? applicationId = null) { }
-        public static Azure.Core.Pipeline.UserAgentValue FromType<T>(string? applicationId = null) { throw null; }
-        public override string ToString() { throw null; }
-    }
 }
 namespace Azure.Core.Serialization
 {
diff --git a/sdk/core/Azure.Core/api/Azure.Core.netcoreapp2.1.cs b/sdk/core/Azure.Core/api/Azure.Core.netcoreapp2.1.cs
@@ -652,6 +652,14 @@ public StatusCodeClassifier(System.ReadOnlySpan<ushort> successStatusCodes) { }
         public override bool IsErrorResponse(Azure.Core.HttpMessage message) { throw null; }
     }
     public delegate System.Threading.Tasks.Task SyncAsyncEventHandler<T>(T e) where T : Azure.SyncAsyncEventArgs;
+    public partial class TelemetryDetails
+    {
+        public TelemetryDetails(System.Reflection.Assembly assembly, string? applicationId = null) { }
+        public string? ApplicationId { get { throw null; } }
+        public System.Reflection.Assembly Assembly { get { throw null; } }
+        public void Apply(Azure.Core.HttpMessage message) { }
+        public override string ToString() { throw null; }
+    }
     public abstract partial class TokenCredential
     {
         protected TokenCredential() { }
@@ -902,10 +910,6 @@ public void Dispose() { }
         public override void Process(Azure.Core.HttpMessage message) { }
         public override System.Threading.Tasks.ValueTask ProcessAsync(Azure.Core.HttpMessage message) { throw null; }
     }
-    public static partial class HttpMessageExtensions
-    {
-        public static void SetUserAgentString(this Azure.Core.HttpMessage message, Azure.Core.Pipeline.UserAgentValue userAgentValue) { }
-    }
     public partial class HttpPipeline
     {
         public HttpPipeline(Azure.Core.Pipeline.HttpPipelineTransport transport, Azure.Core.Pipeline.HttpPipelinePolicy[]? policies = null, Azure.Core.ResponseClassifier? responseClassifier = null) { }
@@ -962,12 +966,6 @@ public ServerCertificateCustomValidationArgs(System.Security.Cryptography.X509Ce
         public System.Security.Cryptography.X509Certificates.X509Chain? CertificateAuthorityChain { get { throw null; } }
         public System.Net.Security.SslPolicyErrors SslPolicyErrors { get { throw null; } }
     }
-    public partial class UserAgentValue
-    {
-        public UserAgentValue(System.Type type, string? applicationId = null) { }
-        public static Azure.Core.Pipeline.UserAgentValue FromType<T>(string? applicationId = null) { throw null; }
-        public override string ToString() { throw null; }
-    }
 }
 namespace Azure.Core.Serialization
 {
diff --git a/sdk/core/Azure.Core/api/Azure.Core.netstandard2.0.cs b/sdk/core/Azure.Core/api/Azure.Core.netstandard2.0.cs
@@ -652,6 +652,14 @@ public StatusCodeClassifier(System.ReadOnlySpan<ushort> successStatusCodes) { }
         public override bool IsErrorResponse(Azure.Core.HttpMessage message) { throw null; }
     }
     public delegate System.Threading.Tasks.Task SyncAsyncEventHandler<T>(T e) where T : Azure.SyncAsyncEventArgs;
+    public partial class TelemetryDetails
+    {
+        public TelemetryDetails(System.Reflection.Assembly assembly, string? applicationId = null) { }
+        public string? ApplicationId { get { throw null; } }
+        public System.Reflection.Assembly Assembly { get { throw null; } }
+        public void Apply(Azure.Core.HttpMessage message) { }
+        public override string ToString() { throw null; }
+    }
     public abstract partial class TokenCredential
     {
         protected TokenCredential() { }
@@ -902,10 +910,6 @@ public void Dispose() { }
         public override void Process(Azure.Core.HttpMessage message) { }
         public override System.Threading.Tasks.ValueTask ProcessAsync(Azure.Core.HttpMessage message) { throw null; }
     }
-    public static partial class HttpMessageExtensions
-    {
-        public static void SetUserAgentString(this Azure.Core.HttpMessage message, Azure.Core.Pipeline.UserAgentValue userAgentValue) { }
-    }
     public partial class HttpPipeline
     {
         public HttpPipeline(Azure.Core.Pipeline.HttpPipelineTransport transport, Azure.Core.Pipeline.HttpPipelinePolicy[]? policies = null, Azure.Core.ResponseClassifier? responseClassifier = null) { }
@@ -962,12 +966,6 @@ public ServerCertificateCustomValidationArgs(System.Security.Cryptography.X509Ce
         public System.Security.Cryptography.X509Certificates.X509Chain? CertificateAuthorityChain { get { throw null; } }
         public System.Net.Security.SslPolicyErrors SslPolicyErrors { get { throw null; } }
     }
-    public partial class UserAgentValue
-    {
-        public UserAgentValue(System.Type type, string? applicationId = null) { }
-        public static Azure.Core.Pipeline.UserAgentValue FromType<T>(string? applicationId = null) { throw null; }
-        public override string ToString() { throw null; }
-    }
 }
 namespace Azure.Core.Serialization
 {
diff --git a/sdk/core/Azure.Core/src/HttpMessage.cs b/sdk/core/Azure.Core/src/HttpMessage.cs
@@ -17,7 +17,7 @@ public sealed class HttpMessage : IDisposable
         /// <summary>
         /// This dictionary is keyed with <c>Type</c> for a couple of reasons. Primarily, it allows values to be stored such that even if the accessor methods
         /// become public, storing values keyed by internal types make them inaccessible to other assemblies. This protects internal values from being overwritten
-        /// by external code. See the <see cref="UserAgentValue"/> and <see cref="UserAgentValueKey"/> types for an example of this usage.
+        /// by external code. See the <see cref="TelemetryDetails"/> and <see cref="UserAgentValueKey"/> types for an example of this usage.
         /// </summary>
         private Dictionary<Type, object>? _typeProperties;
 
diff --git a/sdk/core/Azure.Core/src/Pipeline/HttpMessageExtensions.cs b/sdk/core/Azure.Core/src/Pipeline/HttpMessageExtensions.cs
diff --git a/sdk/core/Azure.Core/src/Pipeline/HttpPipelineBuilder.cs b/sdk/core/Azure.Core/src/Pipeline/HttpPipelineBuilder.cs
@@ -187,7 +187,8 @@ void AddNonNullPolicies(HttpPipelinePolicy[] policiesToAdd)
         // internal for testing
         internal static TelemetryPolicy CreateTelemetryPolicy(ClientOptions options)
         {
-            var userAgentValue = new UserAgentValue(options.GetType(), options.Diagnostics.ApplicationId);
+            var type = options.GetType();
+            var userAgentValue = new TelemetryDetails(type.Assembly, options.Diagnostics.ApplicationId);
             return new TelemetryPolicy(userAgentValue);
         }
     }
diff --git a/sdk/core/Azure.Core/src/Pipeline/Internal/TelemetryPolicy.cs b/sdk/core/Azure.Core/src/Pipeline/Internal/TelemetryPolicy.cs
@@ -7,9 +7,9 @@ internal class TelemetryPolicy : HttpPipelineSynchronousPolicy
     {
         private readonly string _defaultHeader;
 
-        public TelemetryPolicy(UserAgentValue userAgentValue)
+        public TelemetryPolicy(TelemetryDetails telemetryDetails)
         {
-            _defaultHeader = userAgentValue.ToString();
+            _defaultHeader = telemetryDetails.ToString();
         }
 
         public override void OnSendingRequest(HttpMessage message)
diff --git a/sdk/core/Azure.Core/src/Pipeline/Internal/UserAgentValueKey.cs b/sdk/core/Azure.Core/src/Pipeline/Internal/UserAgentValueKey.cs
@@ -4,7 +4,7 @@
 namespace Azure.Core.Pipeline
 {
     /// <summary>
-    /// Class that serves as the key for <see cref="UserAgentValue"/> UserAgent strings on <see cref="HttpMessage"/>.
+    /// Class that serves as the key for <see cref="TelemetryDetails"/> UserAgent strings on <see cref="HttpMessage"/>.
     /// </summary>
     internal class UserAgentValueKey { }
 }
diff --git a/sdk/core/Azure.Core/src/TelemetryDetails.cs b/sdk/core/Azure.Core/src/TelemetryDetails.cs
@@ -2,47 +2,60 @@
 // Licensed under the MIT License.
 
 using System;
+using System.ComponentModel;
 using System.Reflection;
 using System.Runtime.InteropServices;
+using Azure.Core.Pipeline;
 
-namespace Azure.Core.Pipeline
+namespace Azure.Core
 {
     /// <summary>
-    /// Information about the package to be included in UserAgent telemetry
+    /// Details about the package to be included in UserAgent telemetry
     /// </summary>
-    public class UserAgentValue
+    public class TelemetryDetails
     {
-        private string _userAgent;
+        private const int MaxApplicationIdLength = 24;
+        private readonly string _userAgent;
 
         /// <summary>
-        /// Initialize an instance of <see cref="UserAgentValue"/> by extracting the name and version information from the <see cref="Assembly"/> associated with the <paramref name="type"/>.
+        /// The package type represented by this <see cref="TelemetryDetails"/> instance.
         /// </summary>
-        /// <param name="type">The <see cref="Type"/> used to generate the package name and version information for the <see cref="UserAgentValue"/> value.</param>
-        /// <param name="applicationId">An optional value to be prepended to the <see cref="UserAgentValue"/>.
+        public Assembly Assembly { get; }
+
+        /// <summary>
+        /// The value of the applicationId used to initialize this <see cref="TelemetryDetails"/> instance.
+        /// </summary>
+        public string? ApplicationId { get; }
+
+        /// <summary>
+        /// Initialize an instance of <see cref="TelemetryDetails"/> by extracting the name and version information from the <see cref="System.Reflection.Assembly"/> associated with the <paramref name="assembly"/>.
+        /// </summary>
+        /// <param name="assembly">The <see cref="System.Reflection.Assembly"/> used to generate the package name and version information for the <see cref="TelemetryDetails"/> value.</param>
+        /// <param name="applicationId">An optional value to be prepended to the <see cref="TelemetryDetails"/>.
         /// This value overrides the behavior of the <see cref="DiagnosticsOptions.ApplicationId"/> property for the <see cref="HttpMessage"/> it is applied to.</param>
-        public UserAgentValue(Type type, string? applicationId = null)
+        public TelemetryDetails(Assembly assembly, string? applicationId = null)
         {
-            var assembly = Assembly.GetAssembly(type);
-            if (assembly == null) throw new ArgumentException($"The type parameter {type.FullName} does not have a valid Assembly");
+            Argument.AssertNotNull(assembly, nameof(assembly));
+            if ( applicationId?.Length > MaxApplicationIdLength)
+            {
+                throw new ArgumentOutOfRangeException(nameof(applicationId), $"{nameof(applicationId)} must be shorter than {MaxApplicationIdLength + 1} characters");
+            }
+
+            Assembly = assembly;
+            ApplicationId = applicationId;
             _userAgent = GenerateUserAgentString(assembly, applicationId);
         }
 
         /// <summary>
-        /// Creates an instance of a <see cref="UserAgentValue"/> based on the Type provided.
+        /// Sets the package name and version portion of the UserAgent telemetry value for the context of the <paramref name="message"/>
+        /// Note: If <see cref="DiagnosticsOptions.IsTelemetryEnabled"/> is false, this value is never used.
         /// </summary>
-        /// <param name="applicationId"></param>
-        /// <typeparam name="T">The type contained by the Assembly used to generate package name and version information.</typeparam>
-        /// <returns></returns>
-        public static UserAgentValue FromType<T>(string? applicationId = null)
+        /// <param name="message">The <see cref="HttpMessage"/> that will use this <see cref="TelemetryDetails"/>.</param>
+        public void Apply(HttpMessage message)
         {
-            return new UserAgentValue(typeof(T), applicationId);
+            message.SetInternalProperty(typeof(UserAgentValueKey), ToString());
         }
 
-        /// <summary>
-        /// Returns a formatted UserAgent string
-        /// </summary>
-        public override string ToString() => _userAgent;
-
         internal static string GenerateUserAgentString(Assembly clientAssembly, string? applicationId = null)
         {
             const string PackagePrefix = "Azure.";
@@ -73,5 +86,10 @@ internal static string GenerateUserAgentString(Assembly clientAssembly, string?
                 ? $"{applicationId} azsdk-net-{assemblyName}/{version} {platformInformation}"
                 : $"azsdk-net-{assemblyName}/{version} {platformInformation}";
         }
+
+        /// <summary>
+        /// The properly formatted UserAgent string based on this <see cref="TelemetryDetails"/> instance.
+        /// </summary>
+        public override string ToString() => _userAgent;
     }
 }
diff --git a/sdk/core/Azure.Core/tests/HttpPipelineBuilderTest.cs b/sdk/core/Azure.Core/tests/HttpPipelineBuilderTest.cs
@@ -137,7 +137,8 @@ public async Task UsesAssemblyNameAndInformationalVersionForTelemetryPolicySetti
             HttpPipeline pipeline = HttpPipelineBuilder.Build(options);
 
             var message = pipeline.CreateMessage();
-            message.SetUserAgentString(UserAgentValue.FromType<string>());
+            var userAgent = new TelemetryDetails(typeof(string).Assembly);
+            userAgent.Apply(message);
             using Request request = message.Request;
             request.Method = RequestMethod.Get;
             request.Uri.Reset(new Uri("http://example.com"));
diff --git a/sdk/core/Azure.Core/tests/TelemetryDetailsTests.cs b/sdk/core/Azure.Core/tests/TelemetryDetailsTests.cs
@@ -0,0 +1,66 @@
+﻿// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License.
+
+using System.Reflection;
+using System.Runtime.InteropServices;
+using Azure.Core.Pipeline;
+using Azure.Core.TestFramework;
+using NUnit.Framework;
+
+namespace Azure.Core.Tests
+{
+    public class TelemetryDetailsTests
+    {
+        private const string appId = "MyApplicationId";
+
+        [Test]
+        public void CtorInitializesValue([Values(null, appId)] string applicationId)
+        {
+            var target = new TelemetryDetails(typeof(TelemetryDetailsTests).Assembly, applicationId);
+
+            var assembly = Assembly.GetAssembly(GetType());
+            AssemblyInformationalVersionAttribute versionAttribute = assembly.GetCustomAttribute<AssemblyInformationalVersionAttribute>();
+            string version = versionAttribute.InformationalVersion;
+            int hashSeparator = version.IndexOfOrdinal('+');
+            if (hashSeparator != -1)
+            {
+                version = version.Substring(0, hashSeparator);
+            }
+            if (applicationId == null)
+            {
+                Assert.AreEqual(
+                    target.ToString(),
+                    $"azsdk-net-Core.Tests/{version} ({RuntimeInformation.FrameworkDescription}; {RuntimeInformation.OSDescription})");
+            }
+            else
+            {
+                Assert.AreEqual(
+                    target.ToString(),
+                    $"{applicationId} azsdk-net-Core.Tests/{version} ({RuntimeInformation.FrameworkDescription}; {RuntimeInformation.OSDescription})");
+            }
+        }
+
+        [Test]
+        public void CtorPopulatesProperties([Values(null, appId)] string applicationId)
+        {
+            var target = new TelemetryDetails(typeof(TelemetryDetailsTests).Assembly, applicationId);
+
+            Assert.AreEqual(typeof(TelemetryDetailsTests).Assembly, target.Assembly);
+            Assert.AreEqual(applicationId, target.ApplicationId);
+        }
+
+        [Test]
+        public void AppliesToMessage()
+        {
+            var target = new TelemetryDetails(typeof(TelemetryDetailsTests).Assembly);
+            var message = new HttpMessage(new MockRequest(), ResponseClassifier.Shared);
+
+            target.Apply(message);
+
+            message.TryGetInternalProperty(typeof(UserAgentValueKey), out var obj);
+            string actualValue = obj as string;
+
+            Assert.AreEqual(target.ToString(), actualValue);
+        }
+    }
+}
diff --git a/sdk/core/Azure.Core/tests/TelemetryPolicyTests.cs b/sdk/core/Azure.Core/tests/TelemetryPolicyTests.cs

Original file line number	Diff line number	Diff line change
`@@ -652,6 +652,14 @@ public StatusCodeClassifier(System.ReadOnlySpan<ushort> successStatusCodes) { }`
`652`	`652`	`public override bool IsErrorResponse(Azure.Core.HttpMessage message) { throw null; }`
`653`	`653`	`}`
`654`	`654`	`public delegate System.Threading.Tasks.Task SyncAsyncEventHandler<T>(T e) where T : Azure.SyncAsyncEventArgs;`
	`655`	`+ public partial class TelemetryDetails`
	`656`	`+ {`
	`657`	`+ public TelemetryDetails(System.Reflection.Assembly assembly, string? applicationId = null) { }`
	`658`	`+ public string? ApplicationId { get { throw null; } }`
	`659`	`+ public System.Reflection.Assembly Assembly { get { throw null; } }`
	`660`	`+ public void Apply(Azure.Core.HttpMessage message) { }`
	`661`	`+ public override string ToString() { throw null; }`
	`662`	`+ }`
`655`	`663`	`public abstract partial class TokenCredential`
`656`	`664`	`{`
`657`	`665`	`protected TokenCredential() { }`
`@@ -902,10 +910,6 @@ public void Dispose() { }`
`902`	`910`	`public override void Process(Azure.Core.HttpMessage message) { }`
`903`	`911`	`public override System.Threading.Tasks.ValueTask ProcessAsync(Azure.Core.HttpMessage message) { throw null; }`
`904`	`912`	`}`
`905`		`- public static partial class HttpMessageExtensions`
`906`		`- {`
`907`		`- public static void SetUserAgentString(this Azure.Core.HttpMessage message, Azure.Core.Pipeline.UserAgentValue userAgentValue) { }`
`908`		`- }`
`909`	`913`	`public partial class HttpPipeline`
`910`	`914`	`{`
`911`	`915`	`public HttpPipeline(Azure.Core.Pipeline.HttpPipelineTransport transport, Azure.Core.Pipeline.HttpPipelinePolicy[]? policies = null, Azure.Core.ResponseClassifier? responseClassifier = null) { }`
`@@ -962,12 +966,6 @@ public ServerCertificateCustomValidationArgs(System.Security.Cryptography.X509Ce`
`962`	`966`	`public System.Security.Cryptography.X509Certificates.X509Chain? CertificateAuthorityChain { get { throw null; } }`
`963`	`967`	`public System.Net.Security.SslPolicyErrors SslPolicyErrors { get { throw null; } }`
`964`	`968`	`}`
`965`		`- public partial class UserAgentValue`
`966`		`- {`
`967`		`- public UserAgentValue(System.Type type, string? applicationId = null) { }`
`968`		`- public static Azure.Core.Pipeline.UserAgentValue FromType<T>(string? applicationId = null) { throw null; }`
`969`		`- public override string ToString() { throw null; }`
`970`		`- }`
`971`	`969`	`}`
`972`	`970`	`namespace Azure.Core.Serialization`
`973`	`971`	`{`
Original file line number	Diff line number	Diff line change
`@@ -187,7 +187,8 @@ void AddNonNullPolicies(HttpPipelinePolicy[] policiesToAdd)`
`187`	`187`	`// internal for testing`
`188`	`188`	`internal static TelemetryPolicy CreateTelemetryPolicy(ClientOptions options)`
`189`	`189`	`{`
`190`		`- var userAgentValue = new UserAgentValue(options.GetType(), options.Diagnostics.ApplicationId);`
	`190`	`+ var type = options.GetType();`
	`191`	`+ var userAgentValue = new TelemetryDetails(type.Assembly, options.Diagnostics.ApplicationId);`
`191`	`192`	`return new TelemetryPolicy(userAgentValue);`
`192`	`193`	`}`
`193`	`194`	`}`
Original file line number	Diff line number	Diff line change
`@@ -7,9 +7,9 @@ internal class TelemetryPolicy : HttpPipelineSynchronousPolicy`
`7`	`7`	`{`
`8`	`8`	`private readonly string _defaultHeader;`
`9`	`9`
`10`		`- public TelemetryPolicy(UserAgentValue userAgentValue)`
	`10`	`+ public TelemetryPolicy(TelemetryDetails telemetryDetails)`
`11`	`11`	`{`
`12`		`- _defaultHeader = userAgentValue.ToString();`
	`12`	`+ _defaultHeader = telemetryDetails.ToString();`
`13`	`13`	`}`
`14`	`14`
`15`	`15`	`public override void OnSendingRequest(HttpMessage message)`
Original file line number	Diff line number	Diff line change
`@@ -4,7 +4,7 @@`
`4`	`4`	`namespace Azure.Core.Pipeline`
`5`	`5`	`{`
`6`	`6`	`/// <summary>`
`7`		`- /// Class that serves as the key for <see cref="UserAgentValue"/> UserAgent strings on <see cref="HttpMessage"/>.`
	`7`	`+ /// Class that serves as the key for <see cref="TelemetryDetails"/> UserAgent strings on <see cref="HttpMessage"/>.`
`8`	`8`	`/// </summary>`
`9`	`9`	`internal class UserAgentValueKey { }`
`10`	`10`	`}`