Image.FromFile 메서드

정의

지정된 파일에서 Image를 만듭니다.Creates an Image from the specified file.

오버로드

FromFile(String)

지정된 파일에서 Image를 만듭니다.Creates an Image from the specified file.

FromFile(String, Boolean)

해당 파일에 포함된 색 관리 정보를 사용하여 지정된 파일에서 Image를 만듭니다.Creates an Image from the specified file using embedded color management information in that file.

FromFile(String)

지정된 파일에서 Image를 만듭니다.Creates an Image from the specified file.

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를 만들 파일의 이름을 포함하는 문자열입니다.A string that contains the name of the file from which to create the Image.

반환

Image

이 메서드가 만드는 Image입니다.The Image this method creates.

예외

파일의 이미지 형식이 잘못된 경우The file does not have a valid image format.

또는-or- GDI+GDI+에서 파일의 픽셀 형식을 지원하지 않는 경우does not support the pixel format of the file.

지정된 파일이 없는 경우The specified file does not exist.

filenameUri인 경우filename is a Uri.

예제

다음 코드 예제에서는 및 메서드를 사용 하는 방법을 보여 줍니다 FromFile GetPropertyItem SetPropertyItem .The following code example demonstrates how to use the FromFileGetPropertyItem and SetPropertyItem methods. 이 예제는 Windows Forms와 함께 사용 하도록 설계 되었습니다.This example is designed to be used with Windows Forms. 이 예제를 실행 하려면 폼에 붙여넣은 다음를 Paint 로 전달 하 여 메서드를 호출 하 여 폼의 이벤트를 처리 DemonstratePropertyItem e PaintEventArgs 합니다.To run this example, paste it into a form, and handle the form's Paint event by calling the DemonstratePropertyItem method, passing e as PaintEventArgs.

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 +에는 다음 파일 형식을 지 원하는 기본 제공 인코더 및 디코더가 있습니다.Managed GDI+ has built-in encoders and decoders that support the following file types:

  • BMPBMP

  • GIFGIF

  • JPEGJPEG

  • PNGPNG

  • TIFFTIFF

이 삭제 될 때까지 파일은 잠긴 상태로 유지 됩니다 Image .The file remains locked until the Image is disposed.

파일에 올바른 이미지 형식이 없거나 GDI+GDI+ 가 파일의 픽셀 형식을 지원 하지 않는 경우이 메서드는 예외를 throw OutOfMemoryException 합니다.If the file does not have a valid image format or if GDI+GDI+ does not support the pixel format of the file, this method throws an OutOfMemoryException exception.

참고

Image클래스는 비트맵의 알파 투명도를 지원 하지 않습니다.The Image class does not support alpha transparency in bitmaps. 알파 투명도를 사용 하려면 픽셀당 32 비트의 PNG 이미지를 사용 합니다.To enable alpha transparency, use PNG images with 32 bits per pixel.

추가 정보

적용 대상

FromFile(String, Boolean)

해당 파일에 포함된 색 관리 정보를 사용하여 지정된 파일에서 Image를 만듭니다.Creates an Image from the specified file using embedded color management information in that file.

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를 만들 파일의 이름을 포함하는 문자열입니다.A string that contains the name of the file from which to create the Image.

useEmbeddedColorManagement
Boolean

이미지 파일에 포함된 색 관리 정보를 사용하려면 true로 설정하고, 그렇지 않으면 false로 설정합니다.Set to true to use color management information embedded in the image file; otherwise, false.

반환

Image

이 메서드가 만드는 Image입니다.The Image this method creates.

예외

파일의 이미지 형식이 잘못된 경우The file does not have a valid image format.

또는-or- GDI+GDI+에서 파일의 픽셀 형식을 지원하지 않는 경우does not support the pixel format of the file.

지정된 파일이 없는 경우The specified file does not exist.

filenameUri인 경우filename is a Uri.

예제

다음 코드 예제에서는 메서드를 사용 하 여 새 비트맵을 가져오는 방법을 보여 줍니다 FromFile .The following code example demonstrates how to obtain a new bitmap using the FromFile method. 또한도 보여 줍니다 TextureBrush .It also demonstrates a TextureBrush.

이 예제는 Windows Forms와 함께 사용 하도록 설계 되었습니다.This example is designed to be used with Windows Forms. 이라는 단추를 포함 하는 폼을 만듭니다 Button2 .Create a form containing a button named Button2. 폼에 코드를 붙여넣고 Button2_Click 메서드를 단추의 이벤트와 연결 Click 합니다.Paste the code into the form and associate the Button2_Click method with the button's Click event.

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 +에는 다음 파일 형식을 지 원하는 기본 제공 인코더 및 디코더가 있습니다.Managed GDI+ has built-in encoders and decoders that support the following file types:

  • BMPBMP

  • GIFGIF

  • JPEGJPEG

  • PNGPNG

  • TIFFTIFF

파일에 올바른 이미지 형식이 없거나 GDI+GDI+ 가 파일의 픽셀 형식을 지원 하지 않는 경우이 메서드는 예외를 throw OutOfMemoryException 합니다.If the file does not have a valid image format or if GDI+GDI+ does not support the pixel format of the file, this method throws an OutOfMemoryException exception.

이 삭제 될 때까지 파일은 잠긴 상태로 유지 됩니다 Image .The file remains locked until the Image is disposed.

useEmbeddedColorManagement매개 변수는 새가 Image 이미지 파일에 포함 된 색 관리 정보에 따라 색 보정을 적용할지 여부를 지정 합니다.The useEmbeddedColorManagement parameter specifies whether the new Image applies color correction according to color management information that is embedded in the image file. 포함 된 정보에는 ICC (국제 색 컨소시엄) 프로필, 감마 값 및 chromaticity 정보가 포함 될 수 있습니다.Embedded information can include International Color Consortium (ICC) profiles, gamma values, and chromaticity information.

참고

Image클래스는 비트맵의 알파 투명도를 지원 하지 않습니다.The Image class does not support alpha transparency in bitmaps. 알파 투명도를 사용 하려면 픽셀당 32 비트의 PNG 이미지를 사용 합니다.To enable alpha transparency, use PNG images with 32 bits per pixel.

추가 정보

적용 대상