Image.FromFile Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Crée un Image à partir du fichier spécifié.
Surcharges
| FromFile(String) |
Crée un Image à partir du fichier spécifié. |
| FromFile(String, Boolean) |
Crée un Image à partir du fichier spécifié, en utilisant les informations de gestion de couleurs incorporées dans ce fichier. |
FromFile(String)
- Source:
- Image.cs
- Source:
- Image.cs
- Source:
- Image.cs
Crée un Image à partir du fichier spécifié.
public:
static System::Drawing::Image ^ FromFile(System::String ^ filename);public static System.Drawing.Image FromFile (string filename);static member FromFile : string -> System.Drawing.ImagePublic Shared Function FromFile (filename As String) As ImageParamètres
Retours
Image créé par cette méthode.
Exceptions
Le format d'image du fichier n'est pas valide.
- ou -
GDI+ ne prend pas en charge le format de pixel du fichier.
Le fichier spécifié n'existe pas.
filename est Uri.
Exemples
L’exemple de code suivant montre comment utiliser les FromFileGetPropertyItem méthodes et SetPropertyItem . Cet exemple est conçu pour être utilisé avec Windows Forms. Pour exécuter cet exemple, collez-le dans un formulaire et gérez l’événement du Paint formulaire en appelant la DemonstratePropertyItem méthode , en passant e comme 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
Remarques
Managed GDI+ dispose d’encodeurs et de décodeurs intégrés qui prennent en charge les types de fichiers suivants :
BMP
GIF
JPEG
PNG
TIFF
Le fichier reste verrouillé jusqu’à ce que le Image soit supprimé.
Si le fichier n’a pas de format d’image valide ou si GDI+ ne prend pas en charge le format de pixels du fichier, cette méthode lève une OutOfMemoryException exception.
Notes
La Image classe ne prend pas en charge la transparence alpha dans les bitmaps. Pour activer la transparence alpha, utilisez des images PNG avec 32 bits par pixel.
Voir aussi
S’applique à
FromFile(String, Boolean)
- Source:
- Image.cs
- Source:
- Image.cs
- Source:
- Image.cs
Crée un Image à partir du fichier spécifié, en utilisant les informations de gestion de couleurs incorporées dans ce fichier.
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.ImagePublic Shared Function FromFile (filename As String, useEmbeddedColorManagement As Boolean) As ImageParamètres
- useEmbeddedColorManagement
- Boolean
true pour utiliser les informations de gestion de couleurs incorporées dans le fichier image ; sinon, false.
Retours
Image créé par cette méthode.
Exceptions
Le format d'image du fichier n'est pas valide.
- ou -
GDI+ ne prend pas en charge le format de pixel du fichier.
Le fichier spécifié n'existe pas.
filename est Uri.
Exemples
L’exemple de code suivant montre comment obtenir une nouvelle bitmap à l’aide de la FromFile méthode . Il illustre également un TextureBrush.
Cet exemple est conçu pour être utilisé avec Windows Forms. Create un formulaire contenant un bouton nommé Button2. Collez le code dans le formulaire et associez la Button2_Click méthode à l’événement du Click bouton.
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
Remarques
Managed GDI+ dispose d’encodeurs et de décodeurs intégrés qui prennent en charge les types de fichiers suivants :
BMP
GIF
JPEG
PNG
TIFF
Si le fichier n’a pas de format d’image valide ou si GDI+ ne prend pas en charge le format de pixels du fichier, cette méthode lève une OutOfMemoryException exception.
Le fichier reste verrouillé jusqu’à ce que le Image soit supprimé.
Le useEmbeddedColorManagement paramètre spécifie si le nouveau Image applique la correction des couleurs en fonction des informations de gestion des couleurs incorporées dans le fichier image. Les informations incorporées peuvent inclure des profils ICC (International Color Consortium), des valeurs gamma et des informations de chromaticité.
Notes
La Image classe ne prend pas en charge la transparence alpha dans les bitmaps. Pour activer la transparence alpha, utilisez des images PNG avec 32 bits par pixel.
