SecurityException.GetObjectData(SerializationInfo, StreamingContext) Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Caution
This API supports obsolete formatter-based serialization. It should not be called or extended by application code.
Sets the SerializationInfo with information about the SecurityException.
public:
override void GetObjectData(System::Runtime::Serialization::SerializationInfo ^ info, System::Runtime::Serialization::StreamingContext context);
public override void GetObjectData (System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);
[System.Obsolete("This API supports obsolete formatter-based serialization. It should not be called or extended by application code.", DiagnosticId="SYSLIB0051", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public override void GetObjectData (System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);
[System.Security.SecurityCritical]
public override void GetObjectData (System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);
override this.GetObjectData : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> unit
[<System.Obsolete("This API supports obsolete formatter-based serialization. It should not be called or extended by application code.", DiagnosticId="SYSLIB0051", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
override this.GetObjectData : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> unit
[<System.Security.SecurityCritical>]
override this.GetObjectData : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> unit
Public Overrides Sub GetObjectData (info As SerializationInfo, context As StreamingContext)
Parameters
- info
- SerializationInfo
The SerializationInfo that holds the serialized object data about the exception being thrown.
- context
- StreamingContext
The StreamingContext that contains contextual information about the source or destination.
- Attributes
Exceptions
The info
parameter is null
.
Examples
The following code shows the use of the GetObjectData method to display the permission state contained in the SerializationInfo object.
Display("Demonstrating the use of the GetObjectData "
"method.");
SerializationInfo^ entryPointSerializatonInfo =
gcnew SerializationInfo(TestSecurityException::typeid,
gcnew FormatterConverter);
exception->GetObjectData(entryPointSerializatonInfo,
*gcnew StreamingContext(StreamingContextStates::All));
Display("The FirstPermissionThatFailed from the call"
" to GetObjectData is: ");
Display(entryPointSerializatonInfo->GetString(
"FirstPermissionThatFailed"));
Display("Demonstrating the use of the GetObjectData method.");
SerializationInfo si = new SerializationInfo(
typeof(EntryPoint), new FormatterConverter());
sE.GetObjectData(si,
new StreamingContext(StreamingContextStates.All));
Display("The FirstPermissionThatFailed from the " +
"call to GetObjectData is: ");
Display(si.GetString("FirstPermissionThatFailed"));
Display("Demonstrating the use of the GetObjectData method.")
Dim si As New SerializationInfo( _
GetType(EntryPoint), New FormatterConverter())
sE.GetObjectData(si, _
New StreamingContext(StreamingContextStates.All))
Display("The FirstPermissionThatFailed from the " & _
"call to GetObjectData is: ")
Display(si.GetString("FirstPermissionThatFailed"))
End Try
Remarks
GetObjectData
sets a SerializationInfo with all the exception object data targeted for serialization. During deserialization, the exception is reconstituted from the SerializationInfo
transmitted over the stream.