내보내기(0) 인쇄
모두 확장
정보
요청한 주제가 아래에 표시됩니다. 그러나 이 주제는 이 라이브러리에 포함되지 않습니다.

ArgumentException 클래스

2013-12-13

메서드에 제공된 인수 중 하나가 유효하지 않을 때 발생되는 예외입니다.

Namespace:  System
어셈블리:  mscorlib(mscorlib.dll)

public class ArgumentException : SystemException

ArgumentException 형식에서는 다음과 같은 멤버를 노출합니다.

  이름설명
Public 메서드ArgumentException()ArgumentException 클래스의 새 인스턴스를 초기화합니다.
Public 메서드ArgumentException(String)지정된 오류 메시지를 사용하여 ArgumentException 클래스의 새 인스턴스를 초기화합니다.
Public 메서드ArgumentException(String, Exception)지정된 오류 메시지와 해당 예외의 근본 원인인 내부 예외에 대한 참조를 사용하여 ArgumentException 클래스의 새 인스턴스를 초기화합니다.
Public 메서드ArgumentException(String, String)지정된 오류 메시지와 이 예외를 발생한 매개 변수의 이름을 사용하여 ArgumentException 클래스의 새 인스턴스를 초기화합니다.
Public 메서드ArgumentException(String, String, Exception)지정된 오류 메시지, 매개 변수 이름 및 이 예외의 근본 원인인 내부 예외에 대한 참조를 사용하여 ArgumentException 클래스의 새 인스턴스를 초기화합니다.
맨 위

  이름설명
Public 속성Data예외에 대한 사용자 정의 추가 정보를 제공하는 키/값 쌍의 컬렉션을 가져옵니다. (Exception에서 상속됨)
Public 속성HelpLink이 예외와 관련된 도움말 파일에 대한 링크를 가져오거나 설정합니다. (Exception에서 상속됨)
Public 속성HResult특정 예외에 할당된 코드화된 숫자 값인 HRESULT를 가져오거나 설정합니다. (Exception에서 상속됨)
Public 속성InnerException현재 예외를 발생시킨 Exception 인스턴스를 가져옵니다. (Exception에서 상속됨)
Public 속성Message오류 메시지 및 매개 변수 이름을 가져오거나, 매개 변수 이름이 설정되지 않은 경우에는 오류 메시지만 가져옵니다. (Exception.Message을(를) 재정의함)
Public 속성ParamName이 예외를 발생시킨 매개 변수의 이름을 가져옵니다.
Public 속성Source오류를 발생시키는 응용프로그램 또는 개체의 이름을 가져오거나 설정합니다. (Exception에서 상속됨)
Public 속성StackTrace현재 예외가 발생된 시간에 호출 스택의 프레임에 대한 문자열 표현을 가져옵니다. (Exception에서 상속됨)
맨 위

  이름설명
Public 메서드Equals(Object)지정한 Object가 현재 Object와 같은지 확인합니다. (Object에서 상속됨)
Protected 메서드Finalize가비지 수집기에서 Object를 회수하기 전에 개체가 리소스를 해제하고 다른 정리 작업을 수행할 수 있게 합니다. (Object에서 상속됨)
Public 메서드GetBaseException파생 클래스에서 재정의되었을 때, 하나 이상의 후속 예외의 근본 원인이 되는 Exception을 반환합니다. (Exception에서 상속됨)
Public 메서드GetHashCode특정 형식에 대한 해시 함수 역할을 합니다. (Object에서 상속됨)
Public 메서드GetType현재 인스턴스의 런타임 형식을 가져옵니다. (Exception에서 상속됨)
Protected 메서드MemberwiseClone현재 Object의 단순 복사본을 만듭니다. (Object에서 상속됨)
Public 메서드ToString현재 예외에 대한 문자열 표현을 만들고 반환합니다. (Exception에서 상속됨)
맨 위

ArgumentException은 메서드가 호출될 때 전달된 인수 중 적어도 하나가 호출된 메서드의 매개 변수 사양에 맞지 않는 경우 발생됩니다. ArgumentException의 모든 인스턴스는 잘못된 인수와 해당 인수에 대한 예상 값 범위를 설명하는 의미 있는 오류 메시지를 전달합니다.

ArgumentException의 기본 파생 클래스는 ArgumentNullExceptionArgumentOutOfRangeException입니다. 이 파생 클래스는 해당 클래스를 사용할 수 없는 경우를 제외하고 ArgumentException 대신 사용해야 합니다. 예를 들어, 다음과 같은 경우에 예외가 발생합니다.

  • null 인수를 유효한 인수로 적용하지 않는 메서드에 해당 인수가 전달되면 ArgumentNullException 예외가 발생합니다.

  • 인수의 값이 적용할 수 있는 값 범위를 벗어난 경우(예: DateTime을 생성할 때 "46"이 달을 나타내는 인수로 전달된 경우)에는 ArgumentOutOfRangeException 예외가 발생합니다.

메서드를 호출할 때 인수를 사용하지 않았거나 해당 오류가 인수와 관련되지 않은 경우에는 InvalidOperationException이 사용됩니다.

ArgumentException은 0x80070057 값을 가지는 HRESULT COR_E_ARGUMENT를 사용합니다.

ArgumentException 인스턴스의 초기 속성 값 목록에 대한 자세한 내용은 ArgumentException 생성자를 참조하세요.

버전 메모

Windows Phone

 ArgumentException형식 예외 'System.ArgumentException' 대신 메시지 인수 예외를 표시합니다.

다음 예제에서는 ArgumentException을 발생하고 처리하는 방법을 보여 줍니다.

참고참고:

이 예제를 실행하려면 Windows Phone용 정적 TextBlock 컨트롤이 있는 예제 빌드를 참조하세요.


using System;

public sealed class Example
{
   public static void Demo(System.Windows.Controls.TextBlock outputBlock)
   {
      // ArgumentException is not thrown because 10 is an even number.
      outputBlock.Text += String.Format("10 divided by 2 is {0}", DivideByTwo(10)) + "\n";
      try
      {
         // ArgumentException is thrown because 7 is not an even number.
         outputBlock.Text += String.Format("7 divided by 2 is {0}", DivideByTwo(7)) + "\n";
      }
      catch (ArgumentException)
      {
         // Show the user that 7 cannot be divided by 2.
         outputBlock.Text += "7 is not divided by 2 integrally." + "\n";
      }
   }

   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.


Windows Phone OS

지원되는 버전: 8.0, 7.1, 7.0

Windows Phone

이 형식의 모든 공용 static(Visual Basic의 경우 Shared) 멤버는 스레드로부터 안전합니다. 모든 인스턴스 멤버는 스레드로부터 안전하지 않을 수 있습니다.

표시:
© 2014 Microsoft