PictureBox.Load 메서드

정의

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

오버로드

Load()

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

Load(String)

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

Load()

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

public:
 void Load();
public void Load ();
member this.Load : unit -> unit
Public Sub Load ()

예외

ImageLocationnull 또는 빈 문자열인 경우

설명

.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>
    

추가 정보

적용 대상

Load(String)

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에 표시할 이미지의 경로입니다.

예외

urlnull 또는 빈 문자열인 경우

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

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

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>
    

추가 정보

적용 대상