System.Runtime.InteropServices docs

Author: ericstj

xml/System.Runtime.InteropServices.JavaScript/JSObject.xml

@@ -89,6 +89,8 @@
         <returns>The value of the property with the specified name.</returns>
         <remarks>This method throws a <see cref="T:System.Runtime.InteropServices.JavaScript.JSException" /> when the property value is not a Boolean.</remarks>
         <exception cref="T:System.Runtime.InteropServices.JavaScript.JSException">The property value is not a <see cref="T:System.Boolean" />.</exception>
+        <seealso cref="M:System.Runtime.InteropServices.JavaScript.JSObject.GetTypeOfProperty(System.String)" />
+        <seealso cref="M:System.Runtime.InteropServices.JavaScript.JSObject.HasProperty(System.String)" />
       </Docs>
     </Member>
     <Member MemberName="GetPropertyAsByteArray">
@@ -124,6 +126,8 @@
         <returns>The value of the property with the specified name.</returns>
         <remarks>This method throws a <see cref="T:System.Runtime.InteropServices.JavaScript.JSException" /> when the property value is not an array.</remarks>
         <exception cref="T:System.Runtime.InteropServices.JavaScript.JSException">The property value is not an array.</exception>
+        <seealso cref="M:System.Runtime.InteropServices.JavaScript.JSObject.GetTypeOfProperty(System.String)" />
+        <seealso cref="M:System.Runtime.InteropServices.JavaScript.JSObject.HasProperty(System.String)" />
       </Docs>
     </Member>
     <Member MemberName="GetPropertyAsDouble">
@@ -153,6 +157,8 @@
         <returns>The value of the property with the specified name.</returns>
         <remarks>This method throws a <see cref="T:System.Runtime.InteropServices.JavaScript.JSException" /> when the property value is not a number.</remarks>
         <exception cref="T:System.Runtime.InteropServices.JavaScript.JSException">The property value is not a number.</exception>
+        <seealso cref="M:System.Runtime.InteropServices.JavaScript.JSObject.GetTypeOfProperty(System.String)" />
+        <seealso cref="M:System.Runtime.InteropServices.JavaScript.JSObject.HasProperty(System.String)" />
       </Docs>
     </Member>
     <Member MemberName="GetPropertyAsInt32">
@@ -182,6 +188,8 @@
         <returns>The value of the property with the specified name.</returns>
         <remarks>This method throws a <see cref="T:System.Runtime.InteropServices.JavaScript.JSException" /> when the property value is not an integer.</remarks>
         <exception cref="T:System.Runtime.InteropServices.JavaScript.JSException">The property value is not an integer.</exception>
+        <seealso cref="M:System.Runtime.InteropServices.JavaScript.JSObject.GetTypeOfProperty(System.String)" />
+        <seealso cref="M:System.Runtime.InteropServices.JavaScript.JSObject.HasProperty(System.String)" />
       </Docs>
     </Member>
     <Member MemberName="GetPropertyAsJSObject">
@@ -217,6 +225,8 @@
         <returns>The value of the property with the specified name.</returns>
         <remarks>This method throws a <see cref="T:System.Runtime.InteropServices.JavaScript.JSException" /> when the property value is not an object.</remarks>
         <exception cref="T:System.Runtime.InteropServices.JavaScript.JSException">The property value is not a <see cref="T:System.Runtime.InteropServices.JavaScript.JSObject" />.</exception>
+        <seealso cref="M:System.Runtime.InteropServices.JavaScript.JSObject.GetTypeOfProperty(System.String)" />
+        <seealso cref="M:System.Runtime.InteropServices.JavaScript.JSObject.HasProperty(System.String)" />
       </Docs>
     </Member>
     <Member MemberName="GetPropertyAsString">
@@ -252,6 +262,8 @@
         <returns>The value of the property with the specified name.</returns>
         <remarks>This method throws a <see cref="T:System.Runtime.InteropServices.JavaScript.JSException" /> when the property value is not a string.</remarks>
         <exception cref="T:System.Runtime.InteropServices.JavaScript.JSException">The property value is not a string.</exception>
+        <seealso cref="M:System.Runtime.InteropServices.JavaScript.JSObject.GetTypeOfProperty(System.String)" />
+        <seealso cref="M:System.Runtime.InteropServices.JavaScript.JSObject.HasProperty(System.String)" />
       </Docs>
     </Member>
     <Member MemberName="GetTypeOfProperty">

xml/System.Runtime.InteropServices.Marshalling/GeneratedComInterfaceAttribute.xml

@@ -65,9 +65,9 @@
         <ReturnType>System.Type</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Gets or sets the <see cref="T:System.Type" /> used to control how exceptions are marshalled for all methods on the interface.</summary>
         <value>To be added.</value>
-        <remarks>To be added.</remarks>
+        <remarks>If this field is not specified, <see cref="T:System.Runtime.InteropServices.Marshalling.ExceptionAsHResultMarshaller`1" /> is used to marshal exceptions.</remarks>
       </Docs>
     </Member>
     <Member MemberName="Options">

xml/System.Runtime.InteropServices.Marshalling/StrategyBasedComWrappers.xml

@@ -101,6 +101,7 @@
         <returns>
           <see cref="T:System.Runtime.InteropServices.ComWrappers.ComInterfaceEntry" /> pointer containing memory for all COM interface entries.</returns>
         <remarks>To be added.</remarks>
+        <inheritdoc cref="M:System.Runtime.InteropServices.ComWrappers.ComputeVtables(System.Object,System.Runtime.InteropServices.CreateComInterfaceFlags,System.Int32@)" />
       </Docs>
     </Member>
     <Member MemberName="CreateCacheStrategy">
@@ -210,6 +211,7 @@
         <summary>To be added.</summary>
         <returns>To be added.</returns>
         <remarks>To be added.</remarks>
+        <inheritdoc cref="M:System.Runtime.InteropServices.ComWrappers.CreateObject(System.IntPtr,System.Runtime.InteropServices.CreateObjectFlags,System.Object,System.Runtime.InteropServices.CreatedWrapperFlags@)" />
       </Docs>
     </Member>
     <Member MemberName="DefaultIUnknownInterfaceDetailsStrategy">

xml/System.Runtime.InteropServices/JsonMarshal.xml

@@ -15,7 +15,7 @@
   </Base>
   <Interfaces />
   <Docs>
-    <summary>To be added.</summary>
+    <summary>An unsafe class that provides a set of methods to access the underlying data representations of JSON types.</summary>
     <remarks>To be added.</remarks>
   </Docs>
   <Members>
@@ -38,10 +38,11 @@
         <Parameter Name="property" Type="System.Text.Json.JsonProperty" Index="0" FrameworkAlternate="net-10.0;net-10.0-pp;net-8.0-pp;net-9.0-pp;netframework-4.6.2-pp;netframework-4.7.1-pp;netframework-4.7.2-pp;netframework-4.7-pp;netframework-4.8.1-pp;netframework-4.8-pp;netstandard-2.0-pp" />
       </Parameters>
       <Docs>
-        <param name="property">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
-        <remarks>To be added.</remarks>
+        <param name="property">The JSON property from which to extract the span.</param>
+        <summary>Gets a <see cref="T:System.ReadOnlySpan`1" /> view over the raw JSON data of the given <see cref="T:System.Text.Json.JsonProperty" /> name.</summary>
+        <returns>The span containing the raw JSON data of the <paramref name="property" /> name. This will not include the enclosing quotes.</returns>
+        <remarks>&lt;para&gt;&lt;para&gt; While the method itself does check for disposal of the underlying &lt;see cref="T:System.Text.Json.JsonDocument" /&gt;, it is possible that it could be disposed after the method returns, which would result in the span pointing to a buffer that has been returned to the shared pool. Callers should take extra care to make sure that such a scenario isn't possible to avoid potential data corruption.&lt;/para&gt;&lt;para&gt;&lt;/para&gt;</remarks>
+        <exception cref="T:System.ObjectDisposedException">The underlying <see cref="T:System.Text.Json.JsonDocument" /> has been disposed.</exception>
       </Docs>
     </Member>
     <Member MemberName="GetRawUtf8Value">
@@ -64,10 +65,13 @@
         <Parameter Name="element" Type="System.Text.Json.JsonElement" />
       </Parameters>
       <Docs>
-        <param name="element">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
-        <remarks>To be added.</remarks>
+        <param name="element">The JSON element from which to extract the span.</param>
+        <summary>Gets a <see cref="T:System.ReadOnlySpan`1" /> view over the raw JSON data of the given <see cref="T:System.Text.Json.JsonElement" />.</summary>
+        <returns>The span containing the raw JSON data of<paramref name="element" />.</returns>
+        <remarks>
+          <para>While the method itself does check for disposal of the underlying <see cref="T:System.Text.Json.JsonDocument" />, it is possible that it could be disposed after the method returns, which would result in the span pointing to a buffer that has been returned to the shared pool. Callers should take extra care to make sure that such a scenario isn't possible to avoid potential data corruption.</para>
+        </remarks>
+        <exception cref="T:System.ObjectDisposedException">The underlying <see cref="T:System.Text.Json.JsonDocument" /> has been disposed.</exception>
       </Docs>
     </Member>
   </Members>