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

Image.Source 속성

2013-12-13

이미지의 소스를 가져오거나 설정합니다.

Namespace:  System.Windows.Controls
어셈블리:  System.Windows(System.Windows.dll)
XMLNS for XAML: xmlns에 매핑되지 않습니다.

public ImageSource Source { get; set; }
<Image Source="uri"/>

XAML 값

uri

Source 속성에 제공한 문자열은 URI(Uniform Resource Identifier)로 해석됩니다. 이는 IRI(Internationalized Resource Identifier)와는 대조적입니다. 이러한 차이점으로 인해 US-ASCII 이외의 Source를 식별하는 데 사용되는 문자는 인코딩해야 합니다.

상대 참조를 사용할 수 있습니다. 상대 참조는 응용프로그램의 XAP 파일과 관련이 있습니다.

도메인 간 URI 및 스키마 지정은 허용되지만 URI 스키마 혼용은 허용되지 않습니다.

형식별 파일 이름 확장명은 URI 이름 형식이 아니어도 되지만 검색되는 파일이 올바른 이미지 형식이 아니면 런타임 예외가 throw됩니다.

속성 값

형식: System.Windows.Media.ImageSource
그려진 이미지의 소스 개체입니다.

종속성 속성 식별자 필드: SourceProperty

참고참고:

Windows Phone에서는 일부 이미지 형식을 지원하지 않습니다. 이미지 소스의 형식 및 Image에 사용할 수 있는 형식에 대한 자세한 내용은 BitmapImage를 참조하세요.

절대 URL(예: http://contoso.com/myPicture.jpg)을 지정하여 Source를 설정할 수도 있고 응용프로그램의 XAP 파일에 상대적인 URL을 지정할 수도 있습니다.

JavaScript API에서 이 속성에 해당하는 Source 속성은 URI로 확인되는 문자열에 의해 설정되었습니다. 관리되는 API에서 이 속성은 내부 ImageSource 인스턴스를 사용하는데 사실상 이 인스턴스는 파생 클래스인 BitmapImage인 경우가 대부분입니다.

XAML에서 이 속성을 설정할 수 있지만 이 경우에는 속성을 URI로 설정합니다. XAML 동작은 문자열을 URI로 처리하는 내부 형식 변환을 기반으로 하며 BitmapImage(Uri) 생성자를 호출합니다. 그러면 해당 URI에서 스트림이 요청되고 이미지 소스 개체가 반환됩니다.

이미지 소스의 형식 및 Image에 사용할 수 있는 형식에 대한 자세한 내용은 BitmapImage를 참조하세요.

XAML에서 초기 Source 특성 값에 올바른 소스를 지정하지 않으면 ImageFailed 이벤트가 발생할 수 있습니다.

다음 예제에서는 이미지를 만드는 방법을 보여 줍니다.

<Image Source="myPicture.png" />
Image myImage = new Image();
myImage.Source = new BitmapImage(new Uri("myPicture.jpg", UriKind.RelativeOrAbsolute));
LayoutRoot.Children.Add(myImage);

이 예제에서는 Source 속성을 사용하여 표시할 이미지 위치를 지정합니다. 절대 URL(예: http://contoso.com/myPicture.jpg)을 지정하여 Source를 설정할 수도 있고 응용프로그램의 XAP 파일에 상대적인 URL을 지정할 수도 있습니다. 따라서 앞의 예제에서는 myPicture.png와 동일한 폴더에 XAP 파일이 있어야 합니다.

Windows Phone OS

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

Windows Phone

표시:
© 2014 Microsoft