Image.FromFile 메서드

정의

네임스페이스:

System.Drawing

어셈블리:

System.Drawing.Common.dll

패키지:

System.Drawing.Common v8.0.0

지정된 파일에서 Image를 만듭니다.

오버로드

FromFile(String)	지정된 파일에서 Image를 만듭니다.
FromFile(String, Boolean)	해당 파일에 포함된 색 관리 정보를 사용하여 지정된 파일에서 Image를 만듭니다.

FromFile(String)

Source:

Image.cs

지정된 파일에서 Image를 만듭니다.

public:
 static System::Drawing::Image ^ FromFile(System::String ^ filename);

public static System.Drawing.Image FromFile (string filename);

static member FromFile : string -> System.Drawing.Image

Public Shared Function FromFile (filename As String) As Image

매개 변수

filename

String

Image를 만들 파일의 이름을 포함하는 문자열입니다.

반환

Image

이 메서드가 만드는 Image입니다.

예외

OutOfMemoryException

파일의 이미지 형식이 잘못된 경우

또는

GDI+는 파일의 픽셀 형식을 지원하지 않습니다.

FileNotFoundException

지정된 파일이 없는 경우

ArgumentException

filename이 Uri인 경우

예제

다음 코드 예제를 사용 FromFileGetPropertyItem 하는 방법을 보여 줍니다는 및 SetPropertyItem 메서드. 이 예제는 Windows Forms 사용하도록 설계되었습니다. 이 예제를 실행하려면 폼에 붙여넣고 메서드를 호출 DemonstratePropertyItem 하여 폼의 Paint 이벤트를 처리하고 를 로 PaintEventArgs전달 e 합니다.

private:
   void DemonstratePropertyItem( PaintEventArgs^ e )
   {
      // Create two images.
      Image^ image1 = Image::FromFile( "c:\\FakePhoto1.jpg" );
      Image^ image2 = Image::FromFile( "c:\\FakePhoto2.jpg" );

      // Get a PropertyItem from image1.
      PropertyItem^ propItem = image1->GetPropertyItem( 20624 );

      // Change the ID of the PropertyItem.
      propItem->Id = 20625;

      // Set the PropertyItem for image2.
      image2->SetPropertyItem( propItem );

      // Draw the image.
      e->Graphics->DrawImage( image2, 20.0F, 20.0F );
   }

private void DemonstratePropertyItem(PaintEventArgs e)
{

    // Create two images.
    Image image1 = Image.FromFile("c:\\FakePhoto1.jpg");
    Image image2 = Image.FromFile("c:\\FakePhoto2.jpg");

    // Get a PropertyItem from image1.
    PropertyItem propItem = image1.GetPropertyItem(20624);

    // Change the ID of the PropertyItem.
    propItem.Id = 20625;

    // Set the PropertyItem for image2.
    image2.SetPropertyItem(propItem);

    // Draw the image.
    e.Graphics.DrawImage(image2, 20.0F, 20.0F);
}

Private Sub DemonstratePropertyItem(ByVal e As PaintEventArgs)

    ' Create two images.
    Dim image1 As Image = Image.FromFile("c:\FakePhoto1.jpg")
    Dim image2 As Image = Image.FromFile("c:\FakePhoto2.jpg")

    ' Get a PropertyItem from image1.
    Dim propItem As PropertyItem = image1.GetPropertyItem(20624)

    ' Change the ID of the PropertyItem.
    propItem.Id = 20625

    ' Set the PropertyItem for image2.
    image2.SetPropertyItem(propItem)

    ' Draw the image.
    e.Graphics.DrawImage(image2, 20.0F, 20.0F)
End Sub

설명

관리되는 GDI+에는 다음 파일 형식을 지원하는 기본 제공 인코더 및 디코더가 있습니다.

• BMP

• GIF

• JPEG

• PNG

• TIFF

파일이 삭제될 때까지 Image 잠긴 상태로 유지됩니다.

파일에 유효한 이미지 형식이 없거나 GDI+가 파일의 픽셀 형식을 지원하지 않는 경우 이 메서드는 예외를 OutOfMemoryException throw합니다.

참고

클래스는 Image 비트맵의 알파 투명도를 지원하지 않습니다. 알파 투명도를 사용하도록 설정하려면 픽셀당 32비트인 PNG 이미지를 사용합니다.

추가 정보

• 비트맵의 유형

FromFile(String, Boolean)

Source:

Image.cs

해당 파일에 포함된 색 관리 정보를 사용하여 지정된 파일에서 Image를 만듭니다.

public:
 static System::Drawing::Image ^ FromFile(System::String ^ filename, bool useEmbeddedColorManagement);

public static System.Drawing.Image FromFile (string filename, bool useEmbeddedColorManagement);

static member FromFile : string * bool -> System.Drawing.Image

Public Shared Function FromFile (filename As String, useEmbeddedColorManagement As Boolean) As Image

매개 변수

filename

String

Image를 만들 파일의 이름을 포함하는 문자열입니다.

useEmbeddedColorManagement

Boolean

이미지 파일에 포함된 색 관리 정보를 사용하려면 true로 설정하고, 그렇지 않으면 false로 설정합니다.

반환

Image

이 메서드가 만드는 Image입니다.

예외

OutOfMemoryException

파일의 이미지 형식이 잘못된 경우

또는

GDI+는 파일의 픽셀 형식을 지원하지 않습니다.

FileNotFoundException

지정된 파일이 없는 경우

ArgumentException

filename이 Uri인 경우

예제

다음 코드 예제에서는 메서드를 사용 하 여 새 비트맵을 FromFile 가져오는 방법을 보여 줍니다. 또한 을 TextureBrush보여 줍니다.

이 예제는 Windows Forms 사용하도록 설계되었습니다. 라는 단추가 포함된 양식을 만듭니다 Button2. 코드를 양식에 붙여넣고 메서드를 Button2_Click 단추의 Click 이벤트와 연결합니다.

private:
   void Button2_Click( System::Object^ /*sender*/, System::EventArgs^ /*e*/ )
   {
      try
      {
         Bitmap^ image1 = dynamic_cast<Bitmap^>(Image::FromFile( "C:\\Documents and Settings\\"
         "All Users\\Documents\\My Music\\music.bmp", true ));
         TextureBrush^ texture = gcnew TextureBrush( image1 );
         texture->WrapMode = System::Drawing::Drawing2D::WrapMode::Tile;
         Graphics^ formGraphics = this->CreateGraphics();
         formGraphics->FillEllipse( texture, RectangleF(90.0F,110.0F,100,100) );
         delete formGraphics;
      }
      catch ( System::IO::FileNotFoundException^ ) 
      {
         MessageBox::Show( "There was an error opening the bitmap."
         "Please check the path." );
      }
   }

private void Button2_Click(System.Object sender, System.EventArgs e)
{
    try
    {
        Bitmap image1 = (Bitmap) Image.FromFile(@"C:\Documents and Settings\" +
            @"All Users\Documents\My Music\music.bmp", true);

        TextureBrush texture = new TextureBrush(image1);
        texture.WrapMode = System.Drawing.Drawing2D.WrapMode.Tile;
        Graphics formGraphics = this.CreateGraphics();
        formGraphics.FillEllipse(texture, 
            new RectangleF(90.0F, 110.0F, 100, 100));
        formGraphics.Dispose();
    }
    catch(System.IO.FileNotFoundException)
    {
        MessageBox.Show("There was an error opening the bitmap." +
            "Please check the path.");
    }
}

Private Sub Button2_Click(ByVal sender As System.Object, _
    ByVal e As System.EventArgs) Handles Button2.Click
    Try
        Dim image1 As Bitmap = _
            CType(Image.FromFile("C:\Documents and Settings\" _
            & "All Users\Documents\My Music\music.bmp", True), Bitmap)

        Dim texture As New TextureBrush(image1)
        texture.WrapMode = Drawing2D.WrapMode.Tile
        Dim formGraphics As Graphics = Me.CreateGraphics()
        formGraphics.FillEllipse(texture, _
            New RectangleF(90.0F, 110.0F, 100, 100))
        formGraphics.Dispose()

    Catch ex As System.IO.FileNotFoundException
        MessageBox.Show("There was an error opening the bitmap." _
            & "Please check the path.")
    End Try

End Sub

설명

관리되는 GDI+에는 다음 파일 형식을 지원하는 기본 제공 인코더 및 디코더가 있습니다.

• BMP

• GIF

• JPEG

• PNG

• TIFF

파일에 유효한 이미지 형식이 없거나 GDI+가 파일의 픽셀 형식을 지원하지 않는 경우 이 메서드는 예외를 OutOfMemoryException throw합니다.

파일이 삭제될 때까지 Image 잠긴 상태로 유지됩니다.

매개 변수는 useEmbeddedColorManagement 이미지 파일에 포함된 색 관리 정보에 따라 새 Image 가 색 보정을 적용할지 여부를 지정합니다. 포함된 정보에는 ICC(International Color Consortium) 프로필, 감마 값 및 색도 정보가 포함될 수 있습니다.

참고

클래스는 Image 비트맵의 알파 투명도를 지원하지 않습니다. 알파 투명도를 사용하도록 설정하려면 픽셀당 32비트인 PNG 이미지를 사용합니다.

추가 정보

• 비트맵의 유형