PictureBox.Load 메서드

정의

네임스페이스:

System.Windows.Forms

어셈블리:

System.Windows.Forms.dll

PictureBox에 이미지를 표시합니다.

오버로드

Load()	ImageLocation의 PictureBox 속성에서 지정한 이미지를 표시합니다.
Load(String)	ImageLocation을 지정된 URL로 설정하고 지정된 이미지를 표시합니다.

Load()

Source:

PictureBox.cs

ImageLocation의 PictureBox 속성에서 지정한 이미지를 표시합니다.

public:
 void Load();

public void Load ();

member this.Load : unit -> unit

Public Sub Load ()

예외

InvalidOperationException

ImageLocation이 null 또는 빈 문자열인 경우

설명

.NET 8부터 컨트롤이 원격 이미지를 로드하는 방식 PictureBox 의 동작이 변경되었습니다. 기본적으로 속성은 System.Net.ServicePointManager.CheckCertificateRevocationList 를 통해 WebClient원격 이미지를 다운로드하기 전에 로 설정 true 됩니다. 이 설정을 사용하면 인증서가 있는 서버가 유효성 검사 프로세스의 일부로 CRL(인증 기관 해지 목록)에 대해 해당 인증서를 검사하도록 합니다.

경고

원격 이미지가 로드되는 CheckCertificateRevocationList 즉시 는 앱의 수명 동안 으로 true 변경됩니다. 필요한 경우 수동으로 로 되돌리기 false 수 있지만 다른 원격 이미지가 로드되는 즉시 가 로 true설정됩니다CheckCertificateRevocationList.

로컬로 캐시된 CRL이 만료되어 업데이트를 검색할 수 없는 경우 이전에 작업한 원격 리소스가 로드되지 않을 수 있습니다. 이 문제는 앱이 실행 중인 네트워크가 제한되고 CRL 위치가 허용 목록에 없는 경우에 발생할 수 있습니다.

CRL 확인 지연이 앱의 작동 기능에 부정적인 영향을 줄 수도 있습니다.

다음 방법 중 하나로 앱에 대한 옵션을 설정 System.Windows.Forms.ServicePointManagerCheckCrl 하여 이 동작을 옵트아웃할 수 있습니다.

• [app].runtimeconfig.json 구성 파일에서 속성을 false 로 설정합니다.

  {
    "configProperties": {
      "System.Windows.Forms.ServicePointManagerCheckCrl": false
    }
  }
  

• <RuntimeHostConfigurationOption> 프로젝트 파일에 항목을 추가하여 사용하지 않도록 설정합니다.

  <ItemGroup>
    <RuntimeHostConfigurationOption Include="System.Windows.Forms.ServicePointManagerCheckCrl" Value="false" />
  </ItemGroup>
  

추가 정보

• LoadAsync

Load(String)

Source:

PictureBox.cs

ImageLocation을 지정된 URL로 설정하고 지정된 이미지를 표시합니다.

public:
 void Load(System::String ^ url);

public void Load (string url);

member this.Load : string -> unit

Public Sub Load (url As String)

매개 변수

url

String

PictureBox에 표시할 이미지의 경로입니다.

예외

InvalidOperationException

url이 null 또는 빈 문자열인 경우

WebException

url은 액세스할 수 없는 웹 이미지를 참조합니다.

ArgumentException

url은 이미지가 아닌 파일을 참조합니다.

FileNotFoundException

url에서 존재하지 않는 파일을 참조합니다.

설명

매개 변수가 url 로컬 파일을 나타내는 경우 권장되는 형식은 로컬 파일 경로입니다. 예를 들어 c:\에 있는 myPicture.jpg 라는 이미지 파일에는 매개 변수를 url 전달 c:\myPicture.jpg 하여 액세스할 수 있습니다. 와 같은 http://www.contoso.com/path/images/image.jpg전체 경로 또는 ./images/image.jpg같은 상대 경로를 사용할 수 있습니다. 상대 경로를 사용하는 경우 작업 디렉터리를 기준으로 고려됩니다. 메서드에 대한 호출은 Load 속성을 매개 변수 값으로 url 설정합니다ImageLocation.

부하 동작 변경

.NET 8부터 컨트롤이 원격 이미지를 로드하는 방식 PictureBox 의 동작이 변경되었습니다. 기본적으로 속성은 System.Net.ServicePointManager.CheckCertificateRevocationList 를 통해 WebClient원격 이미지를 다운로드하기 전에 로 설정 true 됩니다. 이 설정을 사용하면 인증서가 있는 서버가 유효성 검사 프로세스의 일부로 CRL(인증 기관 해지 목록)에 대해 해당 인증서를 검사하도록 합니다.

경고

원격 이미지가 로드되는 CheckCertificateRevocationList 즉시 는 앱의 수명 동안 으로 true 변경됩니다. 필요한 경우 수동으로 로 되돌리기 false 수 있지만 다른 원격 이미지가 로드되는 즉시 가 로 true설정됩니다CheckCertificateRevocationList.

로컬로 캐시된 CRL이 만료되어 업데이트를 검색할 수 없는 경우 이전에 작업한 원격 리소스가 로드되지 않을 수 있습니다. 이 문제는 앱이 실행 중인 네트워크가 제한되고 CRL 위치가 허용 목록에 없는 경우에 발생할 수 있습니다.

CRL 확인 지연이 앱의 작동 기능에 부정적인 영향을 줄 수도 있습니다.

다음 방법 중 하나로 앱에 대한 옵션을 설정 System.Windows.Forms.ServicePointManagerCheckCrl 하여 이 동작을 옵트아웃할 수 있습니다.

• [app].runtimeconfig.json 구성 파일에서 속성을 false 로 설정합니다.

  {
    "configProperties": {
      "System.Windows.Forms.ServicePointManagerCheckCrl": false
    }
  }
  

• <RuntimeHostConfigurationOption> 프로젝트 파일에 항목을 추가하여 사용하지 않도록 설정합니다.

  <ItemGroup>
    <RuntimeHostConfigurationOption Include="System.Windows.Forms.ServicePointManagerCheckCrl" Value="false" />
  </ItemGroup>
  

추가 정보

• ImageLocation