Продажи: 1-800-867-1389
Информация
Запрошенная вами тема показана ниже. Однако эта тема не включена в библиотеку.

ArgumentException - класс

Это исключение выбрасывается, если один из передаваемых методу аргументов является недопустимым.

Пространство имен:  System
Сборка:  mscorlib (в mscorlib.dll)

[SerializableAttribute]
[ComVisibleAttribute(true)]
public class ArgumentException : SystemException, 
	ISerializable

Тип ArgumentException предоставляет следующие члены.

  ИмяОписание
Открытый методПоддерживается платформой XNA FrameworkПоддерживается в Переносимая библиотека классовПоддерживается в версии: Приложения .NET для Магазина WindowsArgumentException()Инициализирует новый экземпляр класса ArgumentException.
Открытый методПоддерживается платформой XNA FrameworkПоддерживается в Переносимая библиотека классовПоддерживается в версии: Приложения .NET для Магазина WindowsArgumentException(String)Инициализирует новый экземпляр класса ArgumentException с указанным сообщением об ошибке.
Защищенный методArgumentException(SerializationInfo, StreamingContext)Инициализирует новый экземпляр класса ArgumentException с сериализованными данными.
Открытый методПоддерживается платформой XNA FrameworkПоддерживается в Переносимая библиотека классовПоддерживается в версии: Приложения .NET для Магазина WindowsArgumentException(String, Exception)Выполняет инициализацию нового экземпляра класса ArgumentException с указанным сообщением об ошибке и ссылкой на внутреннее исключение, которое стало причиной данного исключения.
Открытый методПоддерживается платформой XNA FrameworkПоддерживается в Переносимая библиотека классовПоддерживается в версии: Приложения .NET для Магазина WindowsArgumentException(String, String)Инициализирует новый экземпляр класса ArgumentException с указанным сообщением об ошибке и именем параметра, ставшего причиной этого исключения.
Открытый методПоддерживается в Переносимая библиотека классовПоддерживается в версии: Приложения .NET для Магазина WindowsArgumentException(String, String, Exception)Инициализирует новый экземпляр класса ArgumentException с указанным сообщением об ошибке, именем параметра и ссылкой на внутреннее исключение, которое является причиной возникновения данного исключения.
В начало страницы

  ИмяОписание
Открытое свойствоПоддерживается в Переносимая библиотека классовПоддерживается в версии: Приложения .NET для Магазина WindowsDataВозвращает коллекцию пар "ключ-значение", предоставляющих дополнительную заданную пользователем информацию об исключении. (Унаследовано от Exception.)
Открытое свойствоПоддерживается в Переносимая библиотека классовПоддерживается в версии: Приложения .NET для Магазина WindowsHelpLinkВозвращает или задает ссылку на файл справки, связанный с этим исключением. (Унаследовано от Exception.)
Открытое свойствоПоддерживается платформой XNA FrameworkПоддерживается в Переносимая библиотека классовПоддерживается в версии: Приложения .NET для Магазина WindowsHResultВозвращает или задает HRESULT — кодированное числовое значение, присвоенное определенному исключению. (Унаследовано от Exception.)
Открытое свойствоПоддерживается платформой XNA FrameworkПоддерживается в Переносимая библиотека классовПоддерживается в версии: Приложения .NET для Магазина WindowsInnerExceptionВозвращает экземпляр объекта Exception, который вызвал текущее исключение. (Унаследовано от Exception.)
Открытое свойствоПоддерживается платформой XNA FrameworkMessageВозвращает сообщение об ошибке и имя параметра или только сообщение об ошибке, если не задан ни один параметр. (Переопределяет Exception.Message.)

В XNA Framework 3.0, этот член наследуется от Exception.Message.
Открытое свойствоПоддерживается в Переносимая библиотека классовПоддерживается в версии: Приложения .NET для Магазина WindowsParamNameВозвращает имя параметра, ставшего причиной этого исключения.
Открытое свойствоПоддерживается в Переносимая библиотека классовПоддерживается в версии: Приложения .NET для Магазина WindowsSourceВозвращает или задает имя приложения или объекта, вызывавшего ошибку. (Унаследовано от Exception.)
Открытое свойствоПоддерживается платформой XNA FrameworkПоддерживается в Переносимая библиотека классовПоддерживается в версии: Приложения .NET для Магазина WindowsStackTraceПолучает строковое представление непосредственных кадров в стеке вызова. (Унаследовано от Exception.)
Открытое свойствоTargetSiteВозвращает метод, создавший текущее исключение. (Унаследовано от Exception.)
В начало страницы

  ИмяОписание
Открытый методПоддерживается платформой XNA FrameworkПоддерживается в Переносимая библиотека классовПоддерживается в версии: Приложения .NET для Магазина WindowsEquals(Object)Определяет, равен ли заданный объект текущему объекту. (Унаследовано от Object.)
Защищенный методПоддерживается платформой XNA FrameworkПоддерживается в Переносимая библиотека классовПоддерживается в версии: Приложения .NET для Магазина WindowsFinalize Позволяет объекту попытаться освободить ресурсы и выполнить другие операции очистки, перед тем как объект будет утилизирован в процессе сборки мусора. (Унаследовано от Object.)
Открытый методПоддерживается платформой XNA FrameworkПоддерживается в Переносимая библиотека классовПоддерживается в версии: Приложения .NET для Магазина WindowsGetBaseExceptionПри переопределении в производном классе возвращает исключение Exception, которое является корневой причиной одного или нескольких последующих исключений. (Унаследовано от Exception.)
Открытый методПоддерживается платформой XNA FrameworkПоддерживается в Переносимая библиотека классовПоддерживается в версии: Приложения .NET для Магазина WindowsGetHashCodeСлужит хэш-функцией по умолчанию. (Унаследовано от Object.)
Открытый методGetObjectDataУстанавливает SerializationInfo с именем параметра и дополнительными сведениями об исключении. (Переопределяет Exception.GetObjectData(SerializationInfo, StreamingContext).)
Открытый методПоддерживается платформой XNA FrameworkПоддерживается в Переносимая библиотека классовПоддерживается в версии: Приложения .NET для Магазина WindowsGetTypeВозвращает тип текущего экземпляра в среде выполнения. (Унаследовано от Exception.)

В XNA Framework 3.0, этот член наследуется от Object.GetType().


В Переносимая библиотека классов Переносимая библиотека классов, этот член наследуется от Object.GetType().


В Приложения .NET для Магазина Windows Windows 8, этот член наследуется от Object.GetType().
Защищенный методПоддерживается платформой XNA FrameworkПоддерживается в Переносимая библиотека классовПоддерживается в версии: Приложения .NET для Магазина WindowsMemberwiseClone Создает неполную копию текущего объекта Object. (Унаследовано от Object.)
Открытый методПоддерживается платформой XNA FrameworkПоддерживается в Переносимая библиотека классовПоддерживается в версии: Приложения .NET для Магазина WindowsToStringСоздает и возвращает строковое представление текущего исключения. (Унаследовано от Exception.)
В начало страницы

  ИмяОписание
Защищенные событияSerializeObjectStateВозникает, когда исключение сериализовано для создания объекта состояния исключения, содержащего сериализованные данные об исключении. (Унаследовано от Exception.)
В начало страницы

Исключение ArgumentException выбрасывается, если при вызове метода, хотя бы один из передаваемых ему аргументов не соответствует спецификации вызываемого метода. Для всех экземпляров класса ArgumentException должны быть предусмотрены понятные сообщение об ошибках, описывающее недопустимый аргумент, а также требуемый диапазон его значений.

У класса ArgumentException есть первичные производные классы: ArgumentNullException и ArgumentOutOfRangeException. Эти производные классы следует использовать вместо класса ArgumentException за исключением случаев, когда все производные классы недоступны. Например, исключения должны выбрасываться следующими объектами:

  • Исключение ArgumentNullException, если значение null передается методу, который не принимает его как недопустимый аргумент.

  • Исключение ArgumentOutOfRangeException, если значение аргумента находится вне диапазона допустимых значений, например, когда значение "46" передается в качестве аргумента месяца при создании объекта DateTime.

Если вызов метода осуществляется без аргументов или если сбой не связан с аргументами как таковыми, следует использовать исключение InvalidOperationException.

В исключении ArgumentException используется параметр HRESULT COR_E_ARGUMENT, значение которого равно 0x80070057.

Список исходных значений свойств для экземпляра класса ArgumentException см. в описании конструкторов ArgumentException.

В следующем примере демонстрируется выбрасывание и перехват исключения ArgumentException.


using System;

public sealed class App 
{
    static void Main() 
    {
        // ArgumentException is not thrown because 10 is an even number.
        Console.WriteLine("10 divided by 2 is {0}", DivideByTwo(10));
        try 
        {
             // ArgumentException is thrown because 7 is not an even number.
             Console.WriteLine("7 divided by 2 is {0}", DivideByTwo(7));
        }
        catch (ArgumentException)
        {
            // Show the user that 7 cannot be divided by 2.
            Console.WriteLine("7 is not divided by 2 integrally.");
        }
    }

    static int DivideByTwo(int num) 
    {
        // If num is an odd number, throw an ArgumentException.
        if ((num & 1) == 1)
            throw new ArgumentException("Number must be even", "num");

        // num is even, return half of its value.
        return num / 2;
    }
}


// This code produces the following output.
// 
// 10 divided by 2 is 5
// 7 is not divided by 2 integrally.


.NET Framework

Поддерживается в версиях: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework (клиентский профиль)

Поддерживается в версиях: 4, 3.5 с пакетом обновления 1 (SP1)

Переносимая библиотека классов

Поддерживается в версии: Переносимая библиотека классов

Приложения .NET для Магазина Windows

Поддерживается в версии: Windows 8

Приложения .NET для Windows Phone

Поддерживается в версиях: Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista с пакетом обновления 2 (SP2), Windows Server 2008 (роль основных серверных компонентов не поддерживается), Windows Server 2008 R2 (роль основных серверных компонентов поддерживается в пакете обновления 1 (SP1) или выше; системы на базе Itanium не поддерживаются)

.NET Framework поддерживает не все версии каждой платформы. Поддерживаемые версии перечислены в разделе Требования к системе для .NET Framework.

Любые открытые члены этого типа, объявленные как static (Shared в Visual Basic), являются потокобезопасными. Потокобезопасность членов экземпляров не гарантируется.
Была ли вам полезна эта информация?
(1500 символов осталось)
Спасибо за ваш отзыв

Добавления сообщества

Корпорация Майкрософт проводит интернет-опрос, чтобы выяснить ваше мнение о веб-сайте MSDN. Если вы желаете принять участие в этом интернет-опросе, он будет отображен при закрытии веб-сайта MSDN.

Вы хотите принять участие?
Показ:
© 2014 Microsoft