BitmapImage.UriSource 속성

정의

네임스페이스:

Windows.UI.Xaml.Media.Imaging

이를 BitmapImage생성한 그래픽 소스 파일의 URI(Uniform Resource Identifier)를 가져오거나 설정합니다.

UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.Media.Imaging.BitmapImage.UriSource(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).

public:
 property Uri ^ UriSource { Uri ^ get(); void set(Uri ^ value); };

Uri UriSource();

void UriSource(Uri value);

public System.Uri UriSource { get; set; }

var uri = bitmapImage.uriSource;
bitmapImage.uriSource = uri;

Public Property UriSource As Uri

<BitmapImage UriSource="uri" />

속성 값

Uri Uri

이를 BitmapImage생성한 그래픽 소스 파일의 URI(Uniform Resource Identifier)를 설명하는 개체입니다.

설명

이 속성은 BaseUri 이미지 원본 파일을 특정 Image 요소에 적용하는 경우 URI를 형성하는 데 유용할 수 있습니다.

메모리가 낮은 경우(메모리가 낮은 휴대폰에서 가장 가능성이 높음) "이미지가 인식할 수 없음" 메시지와 0x88982F60 HRESULT와 함께 예외가 발생할 수 있습니다. 이 예외는 일반적으로 잘못된 데이터를 나타내지만 앱이 메모리 제한에 가까울 경우 예외의 원인은 메모리가 부족할 수 있습니다. 이 경우 메모리를 해제하고 다시 시도하는 것이 좋습니다.

Windows 8 동작

Windows 8에는 이 속성의 setter와 연결된 URI 유효성 검사 논리가 있었습니다. Windows 8.1부터 속성 setter에 대한 유효성 검사가 제거됩니다. 즉, 유효성 검사를 받지 못한다는 의미는 아닙니다. 즉, 원본이 적용된 위치에서 ImageOpened 또는 ImageFailed 이벤트에 Image 대한 처리와 같은 최종 유효성 검사를 수행해야 합니다.

Windows 8용으로 컴파일되었지만 Windows 8.1에서 실행되는 앱은 새 Windows 8.1 동작을 사용합니다.

추가 정보

• Image 및 ImageBrush
• XAML 이미지 샘플