﻿<?xml version="1.0" encoding="utf-8"?><Type Name="ArgumentOutOfRangeException" FullName="System.ArgumentOutOfRangeException" FullNameSP="System_ArgumentOutOfRangeException" Maintainer="ecma"><TypeSignature Language="ILASM" Value=".class public serializable ArgumentOutOfRangeException extends System.ArgumentException" /><TypeSignature Language="C#" Value="public class ArgumentOutOfRangeException : ArgumentException" /><TypeSignature Language="ILAsm" Value=".class public auto ansi serializable beforefieldinit ArgumentOutOfRangeException extends System.ArgumentException" /><MemberOfLibrary>BCL</MemberOfLibrary><AssemblyInfo><AssemblyName>mscorlib</AssemblyName><AssemblyPublicKey>[00 00 00 00 00 00 00 00 04 00 00 00 00 00 00 00 ]</AssemblyPublicKey><AssemblyVersion>1.0.5000.0</AssemblyVersion><AssemblyVersion>2.0.0.0</AssemblyVersion><AssemblyVersion>4.0.0.0</AssemblyVersion></AssemblyInfo><ThreadingSafetyStatement>All public static members of this type are safe for multithreaded operations. No instance members are guaranteed to be thread safe.</ThreadingSafetyStatement><Base><BaseTypeName>System.ArgumentException</BaseTypeName></Base><Interfaces /><Attributes><Attribute><AttributeName>System.Runtime.InteropServices.ComVisible(true)</AttributeName></Attribute></Attributes><Docs><example><para>The following example demonstrates an error that causes 
      the <see cref="T:System.Array" />
      class to throw a <see cref="T:System.ArgumentOutOfRangeException" /> exception.</para><code lang="C#">using System;
class ArgOutOfRangeExample {
 public static void Main() {
 int[] array1 = {0,0};
 int[] array2 = {0,0};
 try {
 Array.Copy(array1,array2,-1);
 }
 catch (ArgumentOutOfRangeException e) {
 Console.WriteLine("Error: {0}",e);
 }
 }
}
   </code><para>The output is</para><c><para>Error: System.ArgumentOutOfRangeException: Non-negative number required.</para><para>Parameter name: length</para><para>at System.Array.Copy(Array sourceArray, Int32 sourceIndex, Array
         destinationArray, Int32 destinationIndex, Int32 length)</para><para>at ArgOutOfRangeExample.Main()</para></c></example><remarks><attribution license="cc4" from="Microsoft" modified="false" /><para>ArgumentOutOfRangeException is thrown when a method is invoked and at least one of the arguments passed to the method is not null and does not contain a valid value.</para><para><see cref="T:System.ArgumentOutOfRangeException" /> is used extensively by: </para><list type="bullet"><item><para>Classes in the <see cref="N:System.Collections" /> and <see cref="N:System.IO" /> namespaces.</para></item><item><para>The <see cref="T:System.Array" /> class.</para></item></list><para>ArgumentOutOfRangeException behaves identically to <see cref="T:System.ArgumentException" />. It is provided so that application code can differentiate between exceptions caused by invalid arguments that are not null, and exceptions caused by null arguments. For errors caused by null arguments, see <see cref="T:System.ArgumentNullException" />.</para><para><see cref="T:System.ArgumentOutOfRangeException" /> uses the HRESULT COR_E_ARGUMENTOUTOFRANGE, which has the value 0x80131502.</para><para>For a list of initial property values for an instance of <see cref="T:System.ArgumentOutOfRangeException" />, see the <see cref="T:System.ArgumentOutOfRangeException" /> constructors.</para></remarks><summary><attribution license="cc4" from="Microsoft" modified="false" /><para>The exception that is thrown when the value of an argument is outside the allowable range of values as defined by the invoked method.</para></summary></Docs><Members><Member MemberName=".ctor"><MemberSignature Language="ILASM" Value="public rtspecialname specialname instance void .ctor()" /><MemberSignature Language="C#" Value="public ArgumentOutOfRangeException ();" /><MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor() cil managed" /><MemberType>Constructor</MemberType><AssemblyInfo><AssemblyVersion>1.0.5000.0</AssemblyVersion><AssemblyVersion>2.0.0.0</AssemblyVersion><AssemblyVersion>4.0.0.0</AssemblyVersion></AssemblyInfo><ReturnValue /><Parameters /><Docs><remarks><attribution license="cc4" from="Microsoft" modified="false" /><para>This constructor initializes the <see cref="P:System.ArgumentException.Message" /> property of the new instance to a system-supplied message that describes the error, such as "Nonnegative number required." This message takes into account the current system culture.</para><para>The following table shows the initial property values for an instance of <see cref="T:System.ArgumentOutOfRangeException" />.</para><list type="table"><listheader><item><term><para>Property </para></term><description><para>Value </para></description></item></listheader><item><term><para><see cref="P:System.Exception.InnerException" /></para></term><description><para>A null reference (Nothing in Visual Basic). </para></description></item><item><term><para><see cref="P:System.ArgumentOutOfRangeException.Message" /></para></term><description><para>The localized error message string. </para></description></item></list></remarks><summary><attribution license="cc4" from="Microsoft" modified="false" /><para>Initializes a new instance of the <see cref="T:System.ArgumentOutOfRangeException" /> class.</para></summary></Docs><Excluded>0</Excluded></Member><Member MemberName=".ctor"><MemberSignature Language="ILASM" Value="public rtspecialname specialname instance void .ctor(string paramName)" /><MemberSignature Language="C#" Value="public ArgumentOutOfRangeException (string paramName);" /><MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(string paramName) cil managed" /><MemberType>Constructor</MemberType><AssemblyInfo><AssemblyVersion>1.0.5000.0</AssemblyVersion><AssemblyVersion>2.0.0.0</AssemblyVersion><AssemblyVersion>4.0.0.0</AssemblyVersion></AssemblyInfo><ReturnValue /><Parameters><Parameter Name="paramName" Type="System.String" /></Parameters><Docs><remarks><attribution license="cc4" from="Microsoft" modified="false" /><para>This constructor initializes the <see cref="P:System.ArgumentException.Message" /> property of the new instance to a system-supplied message that describes the error, such as "Nonnegative number required." This message takes into account the current system culture.</para><para>This constructor initializes the <see cref="P:System.ArgumentException.ParamName" /> property of the new instance using the <paramref name="paramName" /> parameter. The content of <paramref name="paramName" /> is intended to be understood by humans.</para><para>The following table shows the initial property values for an instance of <see cref="T:System.ArgumentOutOfRangeException" />.</para><list type="table"><listheader><item><term><para>Property </para></term><description><para>Value </para></description></item></listheader><item><term><para><see cref="P:System.Exception.InnerException" /></para></term><description><para>A null reference (Nothing in Visual Basic). </para></description></item><item><term><para><see cref="P:System.ArgumentOutOfRangeException.Message" /></para></term><description><para>The empty string (""). </para></description></item><item><term><para><see cref="P:System.ArgumentException.ParamName" /></para></term><description><para>The parameter name string. </para></description></item></list></remarks><summary><attribution license="cc4" from="Microsoft" modified="false" /><para>Initializes a new instance of the <see cref="T:System.ArgumentOutOfRangeException" /> class with the name of the parameter that causes this exception.</para></summary><param name="paramName"><attribution license="cc4" from="Microsoft" modified="false" />The name of the parameter that causes this exception. </param></Docs><Excluded>0</Excluded></Member><Member MemberName=".ctor"><MemberSignature Language="C#" Value="protected ArgumentOutOfRangeException (System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);" /><MemberSignature Language="ILAsm" Value=".method familyhidebysig specialname rtspecialname instance void .ctor(class System.Runtime.Serialization.SerializationInfo info, valuetype System.Runtime.Serialization.StreamingContext context) cil managed" /><MemberType>Constructor</MemberType><AssemblyInfo><AssemblyVersion>1.0.5000.0</AssemblyVersion><AssemblyVersion>2.0.0.0</AssemblyVersion><AssemblyVersion>4.0.0.0</AssemblyVersion></AssemblyInfo><Parameters><Parameter Name="info" Type="System.Runtime.Serialization.SerializationInfo" /><Parameter Name="context" Type="System.Runtime.Serialization.StreamingContext" /></Parameters><Docs><remarks><attribution license="cc4" from="Microsoft" modified="false" /><para>This constructor is called during deserialization to reconstitute the exception object transmitted over a stream. For more information, see <format type="text/html"><a href="832ac524-21bc-419a-a27b-ca8bfc45840f">XML and Soap Serialization</a></format>.</para></remarks><summary><attribution license="cc4" from="Microsoft" modified="false" /><para>Initializes a new instance of the <see cref="T:System.ArgumentOutOfRangeException" /> class with serialized data.</para></summary><param name="info"><attribution license="cc4" from="Microsoft" modified="false" />The object that holds the serialized object data. </param><param name="context"><attribution license="cc4" from="Microsoft" modified="false" />An object that describes the source or destination of the serialized data. </param></Docs></Member><Member MemberName=".ctor"><MemberSignature Language="C#" Value="public ArgumentOutOfRangeException (string message, Exception innerException);" /><MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(string message, class System.Exception innerException) cil managed" /><MemberType>Constructor</MemberType><AssemblyInfo><AssemblyVersion>2.0.0.0</AssemblyVersion><AssemblyVersion>4.0.0.0</AssemblyVersion></AssemblyInfo><Parameters><Parameter Name="message" Type="System.String" /><Parameter Name="innerException" Type="System.Exception" /></Parameters><Docs><remarks>To be added.</remarks><since version=".NET 2.0" /><summary><attribution license="cc4" from="Microsoft" modified="false" /><para>Initializes a new instance of the <see cref="T:System.ArgumentOutOfRangeException" /> class with a specified error message and the exception that is the cause of this exception.</para></summary><param name="message"><attribution license="cc4" from="Microsoft" modified="false" />The error message that explains the reason for this exception. </param><param name="innerException"><attribution license="cc4" from="Microsoft" modified="false" />The exception that is the cause of the current exception, or a null reference (Nothing in Visual Basic) if no inner exception is specified. </param></Docs></Member><Member MemberName=".ctor"><MemberSignature Language="ILASM" Value="public rtspecialname specialname instance void .ctor(string paramName, string message)" /><MemberSignature Language="C#" Value="public ArgumentOutOfRangeException (string paramName, string message);" /><MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(string paramName, string message) cil managed" /><MemberType>Constructor</MemberType><AssemblyInfo><AssemblyVersion>1.0.5000.0</AssemblyVersion><AssemblyVersion>2.0.0.0</AssemblyVersion><AssemblyVersion>4.0.0.0</AssemblyVersion></AssemblyInfo><ReturnValue /><Parameters><Parameter Name="paramName" Type="System.String" /><Parameter Name="message" Type="System.String" /></Parameters><Docs><remarks><attribution license="cc4" from="Microsoft" modified="false" /><para>This constructor initializes the <see cref="P:System.ArgumentOutOfRangeException.Message" /> property of the new instance using the value of the <paramref name="message" /> parameter. The content of the <paramref name="message" /> parameter is intended to be understood by humans. The caller of this constructor is required to ensure that this string has been localized for the current system culture.</para><para>This constructor initializes the <see cref="P:System.ArgumentException.ParamName" /> property of the new instance using the <paramref name="paramName" /> parameter. The content of <paramref name="paramName" /> is intended to be understood by humans.</para><para>The following table shows the initial property values for an instance of <see cref="T:System.ArgumentOutOfRangeException" />.</para><list type="table"><listheader><item><term><para>Property </para></term><description><para>Value </para></description></item></listheader><item><term><para><see cref="P:System.Exception.InnerException" /></para></term><description><para>null. </para></description></item><item><term><para><see cref="P:System.ArgumentOutOfRangeException.Message" /></para></term><description><para>The error message string. </para></description></item><item><term><para><see cref="P:System.ArgumentException.ParamName" /></para></term><description><para>The parameter name string. </para></description></item></list></remarks><summary><attribution license="cc4" from="Microsoft" modified="false" /><para>Initializes a new instance of the <see cref="T:System.ArgumentOutOfRangeException" /> class with the name of the parameter that causes this exception and a specified error message.</para></summary><param name="paramName"><attribution license="cc4" from="Microsoft" modified="false" />The name of the parameter that caused the exception. </param><param name="message"><attribution license="cc4" from="Microsoft" modified="false" />The message that describes the error. </param></Docs><Excluded>0</Excluded></Member><Member MemberName=".ctor"><MemberSignature Language="ILASM" Value="public rtspecialname specialname instance void .ctor(string paramName, object actualValue, string message)" /><MemberSignature Language="C#" Value="public ArgumentOutOfRangeException (string paramName, object actualValue, string message);" /><MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(string paramName, object actualValue, string message) cil managed" /><MemberType>Constructor</MemberType><AssemblyInfo><AssemblyVersion>1.0.5000.0</AssemblyVersion><AssemblyVersion>2.0.0.0</AssemblyVersion><AssemblyVersion>4.0.0.0</AssemblyVersion></AssemblyInfo><ReturnValue /><Parameters><Parameter Name="paramName" Type="System.String" /><Parameter Name="actualValue" Type="System.Object" /><Parameter Name="message" Type="System.String" /></Parameters><Docs><remarks><attribution license="cc4" from="Microsoft" modified="false" /><para>This constructor initializes the <see cref="P:System.ArgumentException.ParamName" /> property of the new instance using the <paramref name="paramName" /> parameter, the <see cref="P:System.ArgumentOutOfRangeException.ActualValue" /> property using the <paramref name="actualValue" /> parameter, and the <see cref="P:System.ArgumentException.Message" /> property using the <paramref name="message" /> parameter. The content of the <paramref name="paramName" /> and <paramref name="message" /> parameters is intended to be understood by humans. The caller of this constructor is required to ensure that these strings have been localized for the current system culture.</para><para>The <paramref name="actualValue" /> parameter is not used within the .NET Framework class library. However, the <see cref="P:System.ArgumentOutOfRangeException.ActualValue" /> property is provided so that applications can use the available argument value.</para><para>The <paramref name="actualValue" /> parameter contains an invalid value that is passed to the method and causes this exception to be thrown. This value is stored in the <see cref="P:System.ArgumentOutOfRangeException.ActualValue" /> property and its string representation is appended to the message string held in the <see cref="P:System.ArgumentOutOfRangeException.Message" /> property.</para><para>The following table shows the initial property values for an instance of <see cref="T:System.ArgumentOutOfRangeException" />.</para><list type="table"><listheader><item><term><para>Property </para></term><description><para>Value </para></description></item></listheader><item><term><para><see cref="P:System.ArgumentOutOfRangeException.ActualValue" /></para></term><description><para>The argument value. </para></description></item><item><term><para><see cref="P:System.Exception.InnerException" /></para></term><description><para>The null reference (Nothing in Visual Basic). </para></description></item><item><term><para><see cref="P:System.ArgumentOutOfRangeException.Message" /></para></term><description><para>The error message string. </para></description></item><item><term><para><see cref="P:System.ArgumentException.ParamName" /></para></term><description><para>The parameter name string. </para></description></item></list></remarks><summary><attribution license="cc4" from="Microsoft" modified="false" /><para>Initializes a new instance of the <see cref="T:System.ArgumentOutOfRangeException" /> class with the parameter name, the value of the argument, and a specified error message.</para></summary><param name="paramName"><attribution license="cc4" from="Microsoft" modified="false" />The name of the parameter that caused the exception. </param><param name="actualValue"><attribution license="cc4" from="Microsoft" modified="false" />The value of the argument that causes this exception. </param><param name="message"><attribution license="cc4" from="Microsoft" modified="false" />The message that describes the error. </param></Docs><Excluded>0</Excluded></Member><Member MemberName="ActualValue"><MemberSignature Language="ILASM" Value=".property object ActualValue { public hidebysig virtual specialname object get_ActualValue() }" /><MemberSignature Language="C#" Value="public virtual object ActualValue { get; }" /><MemberSignature Language="ILAsm" Value=".property instance object ActualValue" /><MemberType>Property</MemberType><AssemblyInfo><AssemblyVersion>1.0.5000.0</AssemblyVersion><AssemblyVersion>2.0.0.0</AssemblyVersion><AssemblyVersion>4.0.0.0</AssemblyVersion></AssemblyInfo><ReturnValue><ReturnType>System.Object</ReturnType></ReturnValue><Parameters /><Docs><value><para> A <see cref="T:System.Object" /> that contains the 
   value of the parameter that caused the current exception, or
<see langword="null" /> if no value was specified to the constructor for the current instance.</para></value><remarks><attribution license="cc4" from="Microsoft" modified="false" /><para>Use this property to retrieve the invalid argument.</para><para>The ActualValue property returns the same value that was passed to the constructor, or null if no value was supplied.</para><para>The <see cref="P:System.ArgumentOutOfRangeException.ActualValue" /> property is assigned a value at the time of object construction. If the <see cref="P:System.ArgumentOutOfRangeException.ActualValue" /> property value is not null, a string representation of the value is appended to the message string held by the <see cref="P:System.ArgumentOutOfRangeException.Message" /> property.</para><para>The <see cref="P:System.ArgumentOutOfRangeException.ActualValue" /> property is not used within the .NET Framework class library. It carries a null value in all the <see cref="T:System.ArgumentOutOfRangeException" /> objects thrown by the .NET Framework class library. The <see cref="P:System.ArgumentOutOfRangeException.ActualValue" /> property is provided so that applications can use the available argument value.</para><para>This property is read-only and should be overridden only to customize the content or format of the value.</para></remarks><summary><attribution license="cc4" from="Microsoft" modified="false" /><para>Gets the argument value that causes this exception.</para></summary></Docs><Excluded>0</Excluded></Member><Member MemberName="GetObjectData"><MemberSignature Language="C#" Value="public override void GetObjectData (System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);" /><MemberSignature Language="ILAsm" Value=".method public hidebysig virtual instance void GetObjectData(class System.Runtime.Serialization.SerializationInfo info, valuetype System.Runtime.Serialization.StreamingContext context) cil managed" /><MemberType>Method</MemberType><AssemblyInfo><AssemblyVersion>1.0.5000.0</AssemblyVersion><AssemblyVersion>2.0.0.0</AssemblyVersion><AssemblyVersion>4.0.0.0</AssemblyVersion></AssemblyInfo><ReturnValue><ReturnType>System.Void</ReturnType></ReturnValue><Parameters><Parameter Name="info" Type="System.Runtime.Serialization.SerializationInfo" /><Parameter Name="context" Type="System.Runtime.Serialization.StreamingContext" /></Parameters><Docs><remarks><attribution license="cc4" from="Microsoft" modified="false" /><para><see cref="M:System.ArgumentOutOfRangeException.GetObjectData(System.Runtime.Serialization.SerializationInfo,System.Runtime.Serialization.StreamingContext)" /> sets a <see cref="T:System.Runtime.Serialization.SerializationInfo" /> object with all the exception object data targeted for serialization. During deserialization, the exception object is reconstituted from the <see cref="T:System.Runtime.Serialization.SerializationInfo" /> transmitted over the stream.</para><para>For more information, see <see cref="T:System.Runtime.Serialization.SerializationInfo" />.</para></remarks><summary><attribution license="cc4" from="Microsoft" modified="false" /><para>Sets the <see cref="T:System.Runtime.Serialization.SerializationInfo" /> object with the invalid argument value and additional exception information.</para></summary><param name="info"><attribution license="cc4" from="Microsoft" modified="false" />The object that holds the serialized object data. </param><param name="context"><attribution license="cc4" from="Microsoft" modified="false" />An object that describes the source or destination of the serialized data. </param></Docs></Member><Member MemberName="Message"><MemberSignature Language="C#" Value="public override string Message { get; }" /><MemberSignature Language="ILAsm" Value=".property instance string Message" /><MemberType>Property</MemberType><AssemblyInfo><AssemblyVersion>1.0.5000.0</AssemblyVersion><AssemblyVersion>2.0.0.0</AssemblyVersion><AssemblyVersion>4.0.0.0</AssemblyVersion></AssemblyInfo><ReturnValue><ReturnType>System.String</ReturnType></ReturnValue><Docs><value><para>A <see cref="T:System.String" /> containing the error message. The error message should describe the expected values of the parameter that causes this exception.</para></value><remarks><attribution license="cc4" from="Microsoft" modified="false" /><para>This property overrides <see cref="P:System.ArgumentException.Message" />.</para><para>The error message should describe the expected values of the parameter that causes this exception. The error message should be localized.</para></remarks><summary><attribution license="cc4" from="Microsoft" modified="false" /><para>Gets the error message and the string representation of the invalid argument value, or only the error message if the argument value is null.</para></summary></Docs></Member></Members><TypeExcluded>0</TypeExcluded></Type>