386 lines
16 KiB
XML
386 lines
16 KiB
XML
<?xml version="1.0" encoding="utf-8"?>
|
|
<Type Name="SqlError" FullName="System.Data.SqlClient.SqlError">
|
|
<TypeSignature Language="C#" Value="public sealed class SqlError" Maintainer="auto" />
|
|
<AssemblyInfo>
|
|
<AssemblyName>System.Data</AssemblyName>
|
|
<AssemblyPublicKey>[00 00 00 00 00 00 00 00 04 00 00 00 00 00 00 00]</AssemblyPublicKey>
|
|
<AssemblyVersion>1.0.3300.0</AssemblyVersion>
|
|
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
|
|
<AssemblyVersion>2.0.0.0</AssemblyVersion>
|
|
</AssemblyInfo>
|
|
<ThreadSafetyStatement>Gtk# is thread aware, but not thread safe; See the <link location="node:gtk-sharp/programming/threads">Gtk# Thread Programming</link> for details.</ThreadSafetyStatement>
|
|
<Base>
|
|
<BaseTypeName>System.Object</BaseTypeName>
|
|
</Base>
|
|
<Interfaces />
|
|
<Docs>
|
|
<remarks>
|
|
<attribution license="cc4" from="Microsoft" modified="false" />
|
|
<para>This class is created by the .NET Framework Data Provider for SQL Server when an error occurs. An instance of <see cref="T:System.Data.SqlClient.SqlError" /> is created and managed by the <see cref="T:System.Data.SqlClient.SqlErrorCollection" />, which in turn is created by the <see cref="T:System.Data.SqlClient.SqlException" /> class.</para>
|
|
<para>Messages with a severity level of 10 or less are informational and indicate problems caused by mistakes in information that a user has entered. Severity levels from 11 through 16 are generated by the user, and can be corrected by the user. Severity levels from 17 through 25 indicate software or hardware errors. When a level 17, 18, or 19 error occurs, you can continue working, although you might not be able to execute a particular statement.</para>
|
|
<para>The <see cref="T:System.Data.SqlClient.SqlConnection" /> remains open when the severity level is 19 or less. When the severity level is 20 or greater, the server usually closes the <see cref="T:System.Data.SqlClient.SqlConnection" />. However, the user can reopen the connection and continue. In both cases, a <see cref="T:System.Data.SqlClient.SqlException" /> is generated by the method executing the command.</para>
|
|
<para>For more information on errors generated by ssNoVersion, see <see cref="http://msdn.microsoft.com/library/ms365262.aspx">Cause and Resolution of Database Engine Errors</see>. For more information about severity levels, see <see cref="http://msdn.microsoft.com/en-us/library/ms164086.aspx">Database Engine Error Severities</see>.</para>
|
|
</remarks>
|
|
<summary>
|
|
<attribution license="cc4" from="Microsoft" modified="false" />
|
|
<para>Collects information relevant to a warning or error returned by SQL Server.</para>
|
|
</summary>
|
|
</Docs>
|
|
<Members>
|
|
<Member MemberName="Class">
|
|
<MemberSignature Language="C#" Value="public byte Class { get; }" />
|
|
<MemberType>Property</MemberType>
|
|
<ReturnValue>
|
|
<ReturnType>System.Byte</ReturnType>
|
|
</ReturnValue>
|
|
<Docs>
|
|
<value>To be added: an object of type 'byte'</value>
|
|
<remarks>
|
|
<attribution license="cc4" from="Microsoft" modified="false" />
|
|
<para>Messages with a severity level of 10 or less are informational and indicate problems caused by mistakes in information that a user has entered. Severity levels from 11 through 16 are generated by the user, and can be corrected by the user. Severity levels from 17 through 25 indicate software or hardware errors. When a level 17, 18, or 19 error occurs, you can continue working, although you might not be able to execute a particular statement.</para>
|
|
<para>The <see cref="T:System.Data.SqlClient.SqlConnection" /> remains open when the severity level is 19 or less. When the severity level is 20 or greater, the server usually closes the <see cref="T:System.Data.SqlClient.SqlConnection" />. However, the user can reopen the connection and continue. In both cases, a <see cref="T:System.Data.SqlClient.SqlException" /> is generated by the method executing the command.</para>
|
|
<para>For more information on errors generated by SQL Server, see SQL Server Books Online.</para>
|
|
</remarks>
|
|
<summary>
|
|
<attribution license="cc4" from="Microsoft" modified="false" />
|
|
<para>Gets the severity level of the error returned from SQL Server.</para>
|
|
</summary>
|
|
</Docs>
|
|
<AssemblyInfo>
|
|
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
|
|
<AssemblyVersion>2.0.0.0</AssemblyVersion>
|
|
</AssemblyInfo>
|
|
</Member>
|
|
<Member MemberName="LineNumber">
|
|
<MemberSignature Language="C#" Value="public int LineNumber { get; }" />
|
|
<MemberType>Property</MemberType>
|
|
<ReturnValue>
|
|
<ReturnType>System.Int32</ReturnType>
|
|
</ReturnValue>
|
|
<Docs>
|
|
<value>To be added: an object of type 'int'</value>
|
|
<remarks>
|
|
<attribution license="cc4" from="Microsoft" modified="false" />
|
|
<para>Line numbering starts at 1. If the value is 0, the line number is not applicable.</para>
|
|
<para>For more information on errors generated by SQL Server, see SQL Server Books Online.</para>
|
|
</remarks>
|
|
<summary>
|
|
<attribution license="cc4" from="Microsoft" modified="false" />
|
|
<para>Gets the line number within the Transact-SQL command batch or stored procedure that contains the error.</para>
|
|
</summary>
|
|
</Docs>
|
|
<AssemblyInfo>
|
|
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
|
|
<AssemblyVersion>2.0.0.0</AssemblyVersion>
|
|
</AssemblyInfo>
|
|
</Member>
|
|
<Member MemberName="Message">
|
|
<MemberSignature Language="C#" Value="public string Message { get; }" />
|
|
<MemberType>Property</MemberType>
|
|
<ReturnValue>
|
|
<ReturnType>System.String</ReturnType>
|
|
</ReturnValue>
|
|
<Docs>
|
|
<value>To be added: an object of type 'string'</value>
|
|
<remarks>To be added</remarks>
|
|
<summary>
|
|
<attribution license="cc4" from="Microsoft" modified="false" />
|
|
<para>Gets the text describing the error.</para>
|
|
</summary>
|
|
</Docs>
|
|
<AssemblyInfo>
|
|
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
|
|
<AssemblyVersion>2.0.0.0</AssemblyVersion>
|
|
</AssemblyInfo>
|
|
</Member>
|
|
<Member MemberName="Number">
|
|
<MemberSignature Language="C#" Value="public int Number { get; }" />
|
|
<MemberType>Property</MemberType>
|
|
<ReturnValue>
|
|
<ReturnType>System.Int32</ReturnType>
|
|
</ReturnValue>
|
|
<Docs>
|
|
<value>To be added: an object of type 'int'</value>
|
|
<remarks>
|
|
<attribution license="cc4" from="Microsoft" modified="false" />
|
|
<para>The following table describes the possible values for this property:</para>
|
|
<list type="table">
|
|
<listheader>
|
|
<item>
|
|
<term>
|
|
<para>Source of Error</para>
|
|
</term>
|
|
<description>
|
|
<para>SqlError.Number</para>
|
|
</description>
|
|
<description>
|
|
<para>SqlError.State</para>
|
|
</description>
|
|
<description>
|
|
<para>SqlException has inner Win32Exception (beginning with.NET Framework 4.5)</para>
|
|
</description>
|
|
</item>
|
|
</listheader>
|
|
<item>
|
|
<term>
|
|
<para>Error from server</para>
|
|
</term>
|
|
<description>
|
|
<para>Server error code</para>
|
|
<para>This number corresponds to an entry in the master.dbo.sysmessages table.</para>
|
|
</description>
|
|
<description>
|
|
<para>Typically greater than 0</para>
|
|
</description>
|
|
<description>
|
|
<para>No</para>
|
|
</description>
|
|
</item>
|
|
<item>
|
|
<term>
|
|
<para>Connection timeout</para>
|
|
</term>
|
|
<description>
|
|
<para>-2</para>
|
|
</description>
|
|
<description>
|
|
<para>0</para>
|
|
</description>
|
|
<description>
|
|
<para>Yes (Number = 258)</para>
|
|
</description>
|
|
</item>
|
|
<item>
|
|
<term>
|
|
<para>Communication error (non-LocalDB)</para>
|
|
</term>
|
|
<description>
|
|
<para>Win32 error code</para>
|
|
</description>
|
|
<description>
|
|
<para>0</para>
|
|
</description>
|
|
<description>
|
|
<para>Yes (Number = Win32 error code)</para>
|
|
</description>
|
|
</item>
|
|
<item>
|
|
<term>
|
|
<para>Communication error (LocalDB)</para>
|
|
</term>
|
|
<description>
|
|
<para>Win32 error code</para>
|
|
</description>
|
|
<description>
|
|
<para>0</para>
|
|
</description>
|
|
<description>
|
|
<para>No</para>
|
|
</description>
|
|
</item>
|
|
<item>
|
|
<term>
|
|
<para>Encryption capability mismatch</para>
|
|
</term>
|
|
<description>
|
|
<para>20</para>
|
|
</description>
|
|
<description>
|
|
<para>0</para>
|
|
</description>
|
|
<description>
|
|
<para>No</para>
|
|
</description>
|
|
</item>
|
|
<item>
|
|
<term>
|
|
<para>Failed to start LocalDB</para>
|
|
</term>
|
|
<description>
|
|
<para>Win32 error code</para>
|
|
</description>
|
|
<description>
|
|
<para>0</para>
|
|
</description>
|
|
<description>
|
|
<para>No</para>
|
|
</description>
|
|
</item>
|
|
<item>
|
|
<term>
|
|
<para>Read-only routing failure</para>
|
|
</term>
|
|
<description>
|
|
<para>0</para>
|
|
</description>
|
|
<description>
|
|
<para>0</para>
|
|
</description>
|
|
<description>
|
|
<para>No</para>
|
|
</description>
|
|
</item>
|
|
<item>
|
|
<term>
|
|
<para>Server had severe error processing query</para>
|
|
</term>
|
|
<description>
|
|
<para>0</para>
|
|
</description>
|
|
<description>
|
|
<para>0</para>
|
|
</description>
|
|
<description>
|
|
<para>No</para>
|
|
</description>
|
|
</item>
|
|
<item>
|
|
<term>
|
|
<para>Processed cancellation while parsing results</para>
|
|
</term>
|
|
<description>
|
|
<para>0</para>
|
|
</description>
|
|
<description>
|
|
<para>0</para>
|
|
</description>
|
|
<description>
|
|
<para>No</para>
|
|
</description>
|
|
</item>
|
|
<item>
|
|
<term>
|
|
<para>Failed to create user instance</para>
|
|
</term>
|
|
<description>
|
|
<para>0</para>
|
|
</description>
|
|
<description>
|
|
<para>0</para>
|
|
</description>
|
|
<description>
|
|
<para>No</para>
|
|
</description>
|
|
</item>
|
|
</list>
|
|
<para>For more information on errors generated by SQL Server, see SQL Server Books Online.</para>
|
|
</remarks>
|
|
<summary>
|
|
<attribution license="cc4" from="Microsoft" modified="false" />
|
|
<para>Gets a number that identifies the type of error.</para>
|
|
</summary>
|
|
</Docs>
|
|
<AssemblyInfo>
|
|
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
|
|
<AssemblyVersion>2.0.0.0</AssemblyVersion>
|
|
</AssemblyInfo>
|
|
</Member>
|
|
<Member MemberName="Procedure">
|
|
<MemberSignature Language="C#" Value="public string Procedure { get; }" />
|
|
<MemberType>Property</MemberType>
|
|
<ReturnValue>
|
|
<ReturnType>System.String</ReturnType>
|
|
</ReturnValue>
|
|
<Docs>
|
|
<value>To be added: an object of type 'string'</value>
|
|
<remarks>To be added</remarks>
|
|
<summary>
|
|
<attribution license="cc4" from="Microsoft" modified="false" />
|
|
<para>Gets the name of the stored procedure or remote procedure call (RPC) that generated the error.</para>
|
|
</summary>
|
|
</Docs>
|
|
<AssemblyInfo>
|
|
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
|
|
<AssemblyVersion>2.0.0.0</AssemblyVersion>
|
|
</AssemblyInfo>
|
|
</Member>
|
|
<Member MemberName="Server">
|
|
<MemberSignature Language="C#" Value="public string Server { get; }" />
|
|
<MemberType>Property</MemberType>
|
|
<ReturnValue>
|
|
<ReturnType>System.String</ReturnType>
|
|
</ReturnValue>
|
|
<Docs>
|
|
<value>To be added: an object of type 'string'</value>
|
|
<remarks>To be added</remarks>
|
|
<summary>
|
|
<attribution license="cc4" from="Microsoft" modified="false" />
|
|
<para>Gets the name of the instance of SQL Server that generated the error.</para>
|
|
</summary>
|
|
</Docs>
|
|
<AssemblyInfo>
|
|
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
|
|
<AssemblyVersion>2.0.0.0</AssemblyVersion>
|
|
</AssemblyInfo>
|
|
</Member>
|
|
<Member MemberName="Source">
|
|
<MemberSignature Language="C#" Value="public string Source { get; }" />
|
|
<MemberType>Property</MemberType>
|
|
<ReturnValue>
|
|
<ReturnType>System.String</ReturnType>
|
|
</ReturnValue>
|
|
<Docs>
|
|
<value>To be added: an object of type 'string'</value>
|
|
<remarks>To be added</remarks>
|
|
<summary>
|
|
<attribution license="cc4" from="Microsoft" modified="false" />
|
|
<para>Gets the name of the provider that generated the error.</para>
|
|
</summary>
|
|
</Docs>
|
|
<AssemblyInfo>
|
|
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
|
|
<AssemblyVersion>2.0.0.0</AssemblyVersion>
|
|
</AssemblyInfo>
|
|
</Member>
|
|
<Member MemberName="State">
|
|
<MemberSignature Language="C#" Value="public byte State { get; }" />
|
|
<MemberType>Property</MemberType>
|
|
<ReturnValue>
|
|
<ReturnType>System.Byte</ReturnType>
|
|
</ReturnValue>
|
|
<Docs>
|
|
<value>To be added: an object of type 'byte'</value>
|
|
<remarks>
|
|
<attribution license="cc4" from="Microsoft" modified="false" />
|
|
<para>State is only set for errors that are received from the server.</para>
|
|
<para>For more information on errors generated by ssNoVersion, see <see cref="http://msdn.microsoft.com/library/ms165761.aspx">Understanding Database Engine Errors</see>.</para>
|
|
</remarks>
|
|
<summary>
|
|
<attribution license="cc4" from="Microsoft" modified="false" />
|
|
<para>Some error messages can be raised at multiple points in the code for the Database Engine. For example, an 1105 error can be raised for several different conditions. Each specific condition that raises an error assigns a unique state code.</para>
|
|
</summary>
|
|
</Docs>
|
|
<AssemblyInfo>
|
|
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
|
|
<AssemblyVersion>2.0.0.0</AssemblyVersion>
|
|
</AssemblyInfo>
|
|
</Member>
|
|
<Member MemberName="ToString">
|
|
<MemberSignature Language="C#" Value="public override string ToString ();" />
|
|
<MemberType>Method</MemberType>
|
|
<ReturnValue>
|
|
<ReturnType>System.String</ReturnType>
|
|
</ReturnValue>
|
|
<Parameters />
|
|
<Docs>
|
|
<remarks>
|
|
<attribution license="cc4" from="Microsoft" modified="false" />
|
|
<para>The string is in the form "SqlError:", followed by the <see cref="P:System.Data.SqlClient.SqlError.Message" />, and the stack trace. For example: </para>
|
|
<para>SqlError:UserId or Password not valid. <stack trace> </para>
|
|
</remarks>
|
|
<summary>
|
|
<attribution license="cc4" from="Microsoft" modified="false" />
|
|
<para>Gets the complete text of the error message.</para>
|
|
</summary>
|
|
<returns>
|
|
<attribution license="cc4" from="Microsoft" modified="false" />
|
|
<para>The complete text of the error.</para>
|
|
</returns>
|
|
</Docs>
|
|
<AssemblyInfo>
|
|
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
|
|
<AssemblyVersion>2.0.0.0</AssemblyVersion>
|
|
</AssemblyInfo>
|
|
</Member>
|
|
</Members>
|
|
</Type> |