내보내기(0) 인쇄
모두 확장
이 문서는 기계로 번역한 것입니다. 원본 텍스트를 보려면 포인터를 문서의 문장 위로 올리십시오. 추가 정보
번역
원본
이 항목은 아직 평가되지 않았습니다.- 이 항목 평가

ArgumentOutOfRangeException 클래스

호출된 메서드에서 정의된 허용 가능한 값 범위 밖에 인수 값이 있는 경우 throw되는 예외입니다.

System.Object
  System.Exception
    System.SystemException
      System.ArgumentException
        System.ArgumentOutOfRangeException

네임스페이스:  System
어셈블리:  mscorlib(mscorlib.dll)
[SerializableAttribute]
[ComVisibleAttribute(true)]
public class ArgumentOutOfRangeException : ArgumentException, 
	ISerializable

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

  이름설명
Public 메서드XNA Framework에서 지원에서 지원 이식 가능한 클래스 라이브러리다음에서 지원: Windows 스토어 앱용 .NETArgumentOutOfRangeException() ArgumentOutOfRangeException 클래스의 새 인스턴스를 초기화합니다.
Public 메서드XNA Framework에서 지원에서 지원 이식 가능한 클래스 라이브러리다음에서 지원: Windows 스토어 앱용 .NETArgumentOutOfRangeException(String)이 예외를 throw한 매개 변수의 이름을 사용하여 ArgumentOutOfRangeException 클래스의 새 인스턴스를 초기화합니다.
Protected 메서드ArgumentOutOfRangeException(SerializationInfo, StreamingContext)serialize된 데이터를 사용하여 ArgumentOutOfRangeException 클래스의 새 인스턴스를 초기화합니다.
Public 메서드에서 지원 이식 가능한 클래스 라이브러리다음에서 지원: Windows 스토어 앱용 .NETArgumentOutOfRangeException(String, Exception)지정된 오류 메시지와 이 예외를 발생시킨 예외를 사용하여 ArgumentOutOfRangeException 클래스의 새 인스턴스를 초기화합니다.
Public 메서드XNA Framework에서 지원에서 지원 이식 가능한 클래스 라이브러리다음에서 지원: Windows 스토어 앱용 .NETArgumentOutOfRangeException(String, String)이 예외를 발생시킨 매개 변수의 이름과 지정된 오류 메시지를 사용하여 ArgumentOutOfRangeException 클래스의 새 인스턴스를 초기화합니다.
Public 메서드에서 지원 이식 가능한 클래스 라이브러리다음에서 지원: Windows 스토어 앱용 .NETArgumentOutOfRangeException(String, Object, String)매개 변수 이름, 인수 값 및 지정된 오류 메시지를 사용하여 ArgumentOutOfRangeException 클래스의 새 인스턴스를 초기화합니다.
위쪽
  이름설명
Public 속성에서 지원 이식 가능한 클래스 라이브러리다음에서 지원: Windows 스토어 앱용 .NETActualValue이 예외를 발생시킨 인수 값을 가져옵니다.
Public 속성에서 지원 이식 가능한 클래스 라이브러리다음에서 지원: Windows 스토어 앱용 .NETData예외에 대한 사용자 정의 추가 정보를 제공하는 키/값 쌍의 컬렉션을 가져옵니다. (Exception에서 상속됨)
Public 속성에서 지원 이식 가능한 클래스 라이브러리다음에서 지원: Windows 스토어 앱용 .NETHelpLink이 예외와 관련된 도움말 파일에 대한 링크를 가져오거나 설정합니다. (Exception에서 상속됨)
Public 속성XNA Framework에서 지원에서 지원 이식 가능한 클래스 라이브러리다음에서 지원: Windows 스토어 앱용 .NETHResult특정 예외에 할당된 코드화된 숫자 값인 HRESULT를 가져오거나 설정합니다. (Exception에서 상속됨)
Public 속성XNA Framework에서 지원에서 지원 이식 가능한 클래스 라이브러리다음에서 지원: Windows 스토어 앱용 .NETInnerException현재 예외를 발생시킨 Exception 인스턴스를 가져옵니다. (Exception에서 상속됨)
Public 속성XNA Framework에서 지원Message오류 메시지 및 잘못된 인수 값의 문자열 표현을 가져오거나, 인수 값이 Null인 경우 오류 메시지만 가져옵니다. (ArgumentException.Message을(를) 재정의함)

XNA Framework 3.0에서 이 멤버는 Exception에서 상속됩니다..Message.
Public 속성에서 지원 이식 가능한 클래스 라이브러리다음에서 지원: Windows 스토어 앱용 .NETParamName이 예외를 발생시킨 매개 변수의 이름을 가져옵니다. (ArgumentException에서 상속됨)
Public 속성에서 지원 이식 가능한 클래스 라이브러리다음에서 지원: Windows 스토어 앱용 .NETSource오류를 발생시키는 응용 프로그램 또는 개체의 이름을 가져오거나 설정합니다. (Exception에서 상속됨)
Public 속성XNA Framework에서 지원에서 지원 이식 가능한 클래스 라이브러리다음에서 지원: Windows 스토어 앱용 .NETStackTrace호출 스택의 직접 실행 프레임에 대한 문자열 표현을 가져옵니다. (Exception에서 상속됨)
Public 속성TargetSite현재 예외를 throw하는 메서드를 가져옵니다. (Exception에서 상속됨)
위쪽
  이름설명
Public 메서드XNA Framework에서 지원에서 지원 이식 가능한 클래스 라이브러리다음에서 지원: Windows 스토어 앱용 .NETEquals(Object) 지정한 개체가 현재 개체와 같은지 여부를 확인합니다. (Object에서 상속됨)
Protected 메서드XNA Framework에서 지원에서 지원 이식 가능한 클래스 라이브러리다음에서 지원: Windows 스토어 앱용 .NETFinalize 개체가 가비지 수집자에서 회수되기 전에, 해당 개체에서 리소스를 해제하고 다른 정리 작업을 수행할 수 있게 합니다. (Object에서 상속됨)
Public 메서드XNA Framework에서 지원에서 지원 이식 가능한 클래스 라이브러리다음에서 지원: Windows 스토어 앱용 .NETGetBaseException파생 클래스에서 재정의되었을 때, 하나 이상의 후속 예외의 근본 원인이 되는 Exception을 반환합니다. (Exception에서 상속됨)
Public 메서드XNA Framework에서 지원에서 지원 이식 가능한 클래스 라이브러리다음에서 지원: Windows 스토어 앱용 .NETGetHashCode기본 해시 함수로 작동합니다. (Object에서 상속됨)
Public 메서드GetObjectData잘못된 인수 값 및 추가 예외 정보를 사용하여 SerializationInfo 개체를 설정합니다. (ArgumentException.GetObjectData(SerializationInfo, StreamingContext)을(를) 재정의함)
Public 메서드XNA Framework에서 지원에서 지원 이식 가능한 클래스 라이브러리다음에서 지원: Windows 스토어 앱용 .NETGetType현재 인스턴스의 런타임 형식을 가져옵니다. (Exception에서 상속됨)

XNA Framework 3.0에서 이 멤버는 Object에서 상속됩니다..GetType().


이식 가능한 클래스 라이브러리 이식 가능한 클래스 라이브러리에서 이 멤버는 Object에서 상속됩니다..GetType().


Windows 스토어 앱용 .NET Windows 8에서 이 멤버는 Object에서 상속됩니다..GetType().
Protected 메서드XNA Framework에서 지원에서 지원 이식 가능한 클래스 라이브러리다음에서 지원: Windows 스토어 앱용 .NETMemberwiseClone현재 Object의 단순 복사본을 만듭니다. (Object에서 상속됨)
Public 메서드XNA Framework에서 지원에서 지원 이식 가능한 클래스 라이브러리다음에서 지원: Windows 스토어 앱용 .NETToString현재 예외에 대한 문자열 표현을 만들고 반환합니다. (Exception에서 상속됨)
위쪽
  이름설명
Protected 이벤트SerializeObjectState예외에 대한 serialize된 데이터가 들어 있는 예외 상태 개체가 만들어지도록 예외가 serialize될 때 발생합니다. (Exception에서 상속됨)
위쪽

메서드가 호출되고 메서드에 전달된 하나 이상의 인수가 null이 아니며 올바른 값이 들어 있지 않은 경우 ArgumentOutOfRangeException이 throw됩니다.

ArgumentOutOfRangeException 은 다음 클래스에서 광범위하게 사용됩니다.

ArgumentOutOfRangeException 의 동작은 ArgumentException과 동일합니다. 이것은 응용 프로그램 코드가 null이 아닌 잘못된 인수에 의해 발생된 예외와 null 인수에 의해 발생된 예외를 구별할 수 있도록 제공됩니다. null 인수에 의해 발생된 오류에 대해서는 ArgumentNullException을 참조하십시오.

ArgumentOutOfRangeException 은 0x80131502 값을 가지는 HRESULT COR_E_ARGUMENTOUTOFRANGE를 사용합니다.

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

다음 예제에서는 초청된 손님에 대한 정보를 포함하는 클래스를 정의합니다. 손님이 21세보다 어리면 ArgumentOutOfRangeException 예외가 throw됩니다.


using System;

class Program
{
    static void Main(string[] args)
    {
        try
        {
            Guest guest1 = new Guest("Ben", "Miller", 17);
            Console.WriteLine(guest1.GuestInfo());
        }
        catch (ArgumentOutOfRangeException outOfRange)
        {

            Console.WriteLine("Error: {0}", outOfRange.Message);
        }
    }
}

class Guest
{
    private string FirstName;
    private string LastName;
    private int Age;

    public Guest(string fName, string lName, int age)
    {
        FirstName = fName;
        LastName = lName;
        if (age < 21)
            throw new ArgumentOutOfRangeException("age","All guests must be 21-years-old or older.");
        else
            Age = age;
    }

    public string GuestInfo()
    {
        string gInfo = FirstName + " " + LastName + ", " + Age.ToString();
        return(gInfo);
    }
}


.NET Framework

4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0에서 지원

.NET Framework Client Profile

4, 3.5 SP1에서 지원

이식 가능한 클래스 라이브러리

이식 가능한 클래스 라이브러리에서 지원

Windows 스토어 앱용 .NET

Windows 8에서 지원

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008(서버 코어 역할은 지원되지 않음), Windows Server 2008 R2(서버 코어 역할은 SP1 이상에서 지원, Itanium은 지원되지 않음)

.NET Framework 에서 모든 플랫폼의 전체 버전을 지원하지는 않습니다. 지원되는 버전의 목록을 보려면 다음을 참조하십시오. .NET Framework 시스템 요구 사항.
이 형식의 static(Visual Basic의 경우 Shared) 모든 공용 멤버는 스레드로부터 안전합니다. 인터페이스 멤버는 스레드로부터 안전하지 않습니다.
이 정보가 도움이 되었습니까?
(1500자 남음)
의견을 주셔서 감사합니다.

커뮤니티 추가 항목

추가
Microsoft는 MSDN 웹 사이트에 대한 귀하의 의견을 이해하기 위해 온라인 설문 조사를 진행하고 있습니다. 참여하도록 선택하시면 MSDN 웹 사이트에서 나가실 때 온라인 설문 조사가 표시됩니다.

참여하시겠습니까?
표시:
© 2014 Microsoft. All rights reserved.