CUrl Sınıfı
Bu sınıf bir URL'yi temsil eder. Var olan bir URL dizesini ayrıştırma veya sıfırdan bir dize oluşturma gibi url öğelerini diğerlerinden bağımsız olarak işlemenizi sağlar.
Önemli
Bu sınıf ve üyeleri Windows Çalışma Zamanı yürütülen uygulamalarda kullanılamaz.
Sözdizimi
class CUrl
Üyeler
Ortak Oluşturucular
| Veri Akışı Adı | Açıklama |
|---|---|
| CUrl::CUrl | Oluşturucu. |
| CUrl::~CUrl | Yok edici. |
Genel Yöntemler
| Veri Akışı Adı | Açıklama |
|---|---|
| CUrl::Canonicalize | URL dizesini kurallı forma dönüştürmek için bu yöntemi çağırın. |
| CUrl::Clear | Tüm URL alanlarını temizlemek için bu yöntemi çağırın. |
| CUrl::CrackUrl | URL'nin kodunu çözmek ve ayrıştırmak için bu yöntemi çağırın. |
| CUrl::CreateUrl | URL'yi oluşturmak için bu yöntemi çağırın. |
| CUrl::GetExtraInfo | URL'den ek bilgi (metin veya # metin gibi) almak için bu yöntemi çağırın. |
| CUrl::GetExtraInfoLength | URL'den alınacak ek bilgilerin uzunluğunu (metin veya # metin gibi) almak için bu yöntemi çağırın. |
| CUrl::GetHostName | URL'den ana bilgisayar adını almak için bu yöntemi çağırın. |
| CUrl::GetHostNameLength | Konak adının uzunluğunu almak için bu yöntemi çağırın. |
| CUrl::GetPassword | URL'den parolayı almak için bu yöntemi çağırın. |
| CUrl::GetPasswordLength | Parolanın uzunluğunu almak için bu yöntemi çağırın. |
| CUrl::GetPortNumber | Bağlantı noktası numarasını ATL_URL_PORT açısından almak için bu yöntemi çağırın. |
| CUrl::GetScheme | URL düzenini almak için bu yöntemi çağırın. |
| CUrl::GetSchemeName | URL düzeni adını almak için bu yöntemi çağırın. |
| CUrl::GetSchemeNameLength | URL düzeni adının uzunluğunu almak için bu yöntemi çağırın. |
| CUrl::GetUrlLength | URL uzunluğunu almak için bu yöntemi çağırın. |
| CUrl::GetUrlPath | URL yolunu almak için bu yöntemi çağırın. |
| CUrl::GetUrlPathLength | URL yol uzunluğunu almak için bu yöntemi çağırın. |
| CUrl::GetUserName | URL'den kullanıcı adını almak için bu yöntemi çağırın. |
| CUrl::GetUserNameLength | Kullanıcı adının uzunluğunu almak için bu yöntemi çağırın. |
| CUrl::SetExtraInfo | URL'nin ek bilgilerini (metin veya # metin gibi) ayarlamak için bu yöntemi çağırın. |
| CUrl::SetHostName | Konak adını ayarlamak için bu yöntemi çağırın. |
| CUrl::SetPassword | Parolayı ayarlamak için bu yöntemi çağırın. |
| CUrl::SetPortNumber | Bağlantı noktası numarasını ATL_URL_PORT olarak ayarlamak için bu yöntemi çağırın. |
| CUrl::SetScheme | URL düzenini ayarlamak için bu yöntemi çağırın. |
| CUrl::SetSchemeName | URL düzeni adını ayarlamak için bu yöntemi çağırın. |
| CUrl::SetUrlPath | URL yolunu ayarlamak için bu yöntemi çağırın. |
| CUrl::SetUserName | Kullanıcı adını ayarlamak için bu yöntemi çağırın. |
Ortak İşleçler
| Veri Akışı Adı | Açıklama |
|---|---|
| CUrl::operator = | Belirtilen CUrl nesneyi geçerli CUrl nesneye atar. |
Açıklamalar
CUrl , yol veya bağlantı noktası numarası gibi bir URL'nin alanlarını işlemenize olanak tanır. CUrl aşağıdaki formun URL'lerini anlar:
<Scheme>://<UserName>:<Password>@<HostName>:<PortNumber>/<UrlPath><ExtraInfo>
(Bazı alanlar isteğe bağlıdır.) Örneğin, şu URL'yi göz önünde bulundurun:
http://someone:secret@www.microsoft.com:80/visualc/stuff.htm#contents
CUrl::CrackUrl aşağıdaki gibi ayrıştırıyor:
Düzen: "http" veya ATL_URL_SCHEME_HTTP
UserName: "birisi"
Parola: "gizli"
Ana Bilgisayar Adı: "
www.microsoft.com"PortNumber: 80
UrlPath: "visualc/stuff.htm"
ExtraInfo: "#contents"
UrlPath alanını (örneğin) işlemek için GetUrlPath, GetUrlPathLength ve SetUrlPath kullanabilirsiniz. Tüm URL dizesini oluşturmak için CreateUrl'u kullanabilirsiniz.
Gereksinimler
Üst bilgi: atlutil.h
CUrl::Canonicalize
URL dizesini kurallı forma dönüştürmek için bu yöntemi çağırın.
inline BOOL Canonicalize(DWORD dwFlags = 0) throw();
Parametreler
dwFlags
Kurallılaştırmayı denetleen bayraklar. Hiçbir bayrak belirtilmezse (dwFlags = 0), yöntem tüm güvenli olmayan karakterleri ve meta dizileri (\.,\ ..ve \...gibi) kaçış dizilerine dönüştürür. dwFlags aşağıdaki değerlerden biri olabilir:
ATL_URL_BROWSER_MODE: "#" veya "" sonrasındaki karakterleri kodlamaz veya kodunu çözmez ve "" sonrasındaki boşlukları kaldırmaz. Bu değer belirtilmezse, URL'nin tamamı kodlanır ve sondaki boşluk kaldırılır.
ATL_URL _DECODE: URL ayrıştırmadan önce kaçış dizileri de dahil olmak üzere tüm %XX dizilerini karakterlere dönüştürür.
ATL_URL _ENCODE_PERCENT: Karşılaşılan tüm yüzde işaretlerini kodlar. Varsayılan olarak, yüzde işaretleri kodlanmaz.
ATL_URL _ENCODE_SPACES_ONLY: Yalnızca boşlukları kodlar.
ATL_URL _NO_ENCODE: Güvenli olmayan karakterleri kaçış dizilerine dönüştürmez.
ATL_URL _NO_META: URL'den meta dizileri ("." ve ".." gibi) kaldırmaz.
Dönüş Değeri
Başarılı olduğunda TRUE, hatada YANLIŞ döndürür.
Açıklamalar
Kurallı forma dönüştürme, güvenli olmayan karakterleri ve boşlukları kaçış dizilerine dönüştürmeyi içerir.
CUrl::Clear
Tüm URL alanlarını temizlemek için bu yöntemi çağırın.
inline void Clear() throw();
CUrl::CrackUrl
URL'nin kodunu çözmek ve ayrıştırmak için bu yöntemi çağırın.
BOOL CrackUrl(LPCTSTR lpszUrl, DWORD dwFlags = 0) throw();
Parametreler
lpszUrl
The URL.
dwFlags
lpszUrl içindeki tüm kaçış karakterlerini ayrıştırdıktan sonra gerçek değerlerine dönüştürmek için ATL_URL_DECODE veya ATL_URL_ESCAPE belirtin. (Visual C++ 2005'den önce, ATL_URL_DECODE ayrıştırmadan önce tüm kaçış karakterlerini dönüştürdü.)
Dönüş Değeri
Başarılı olduğunda TRUE, hatada YANLIŞ döndürür.
CUrl::CreateUrl
Bu yöntem, CUrl nesnesinin bileşen alanlarından bir URL dizesi oluşturur.
inline BOOL CreateUrl(
LPTSTR lpszUrl,
DWORD* pdwMaxLength,
DWORD dwFlags = 0) const throw();
Parametreler
lpszUrl
Tam URL dizesini tutan bir dize arabelleği.
pdwMaxLength
LpszUrl dize arabelleğinin uzunluk üst sınırı.
dwFlags
lpszUrl içindeki tüm kaçış karakterlerini gerçek değerlerine dönüştürmek için ATL_URL_ESCAPE belirtin.
Dönüş Değeri
Başarılı olduğunda TRUE, hatada YANLIŞ döndürür.
Açıklamalar
Bu yöntem, aşağıdaki biçimi kullanarak tam URL dizesini oluşturmak için kendi alanlarını ekler:
<scheme>://<user>:<pass>@<domain>:<port><path><extra>
Bu yöntem çağrılırken pdwMaxLength parametresi başlangıçta lpszUrl parametresi tarafından başvuruda bulunılan dize arabelleğinin uzunluk üst sınırını içermelidir. pdwMaxLength parametresinin değeri URL dizesinin gerçek uzunluğuyla güncelleştirilir.
Örnek
Bu örnek, CUrl nesnesinin oluşturulmasını ve URL dizesini almayı gösterir
CUrl url;
// Set the CUrl contents
url.CrackUrl(_T("http://someone:secret@www.microsoft.com:8080/visualc/stuff.htm#contents"));
// Obtain the length of the URL string and allocate a buffer to
// hold its contents
DWORD dwUrlLen = url.GetUrlLength() + 1;
TCHAR* szUrl = new TCHAR[dwUrlLen];
// Retrieve the contents of the CUrl object
url.CreateUrl(szUrl, &dwUrlLen, 0L);
// Cleanup
delete[] szUrl;
CUrl::CUrl
Oluşturucu.
CUrl() throw();
CUrl(const CUrl& urlThat) throw();
Parametreler
urlThat
URL'yi CUrl oluşturmak için kopyalanacak nesne.
CUrl::~CUrl
Yok edici.
~CUrl() throw();
CUrl::GetExtraInfo
URL'den ek bilgi (metin veya # metin gibi) almak için bu yöntemi çağırın.
inline LPCTSTR GetExtraInfo() const throw();
Dönüş Değeri
Ek bilgileri içeren bir dize döndürür.
CUrl::GetExtraInfoLength
URL'den alınacak ek bilgilerin uzunluğunu (metin veya # metin gibi) almak için bu yöntemi çağırın.
inline DWORD GetExtraInfoLength() const throw();
Dönüş Değeri
Ek bilgileri içeren dizenin uzunluğunu döndürür.
CUrl::GetHostName
URL'den ana bilgisayar adını almak için bu yöntemi çağırın.
inline LPCTSTR GetHostName() const throw();
Dönüş Değeri
Ana bilgisayar adını döndürür.
CUrl::GetHostNameLength
Konak adının uzunluğunu almak için bu yöntemi çağırın.
inline DWORD GetHostNameLength() const throw();
Dönüş Değeri
Konak adı uzunluğunu döndürür.
CUrl::GetPassword
URL'den parolayı almak için bu yöntemi çağırın.
inline LPCTSTR GetPassword() const throw();
Dönüş Değeri
Parolayı döndürür.
CUrl::GetPasswordLength
Parolanın uzunluğunu almak için bu yöntemi çağırın.
inline DWORD GetPasswordLength() const throw();
Dönüş Değeri
Parola uzunluğunu döndürür.
CUrl::GetPortNumber
Bağlantı noktası numarasını almak için bu yöntemi çağırın.
inline ATL_URL_PORT GetPortNumber() const throw();
Dönüş Değeri
Bağlantı noktası numarasını döndürür.
CUrl::GetScheme
URL düzenini almak için bu yöntemi çağırın.
inline ATL_URL_SCHEME GetScheme() const throw();
Dönüş Değeri
URL'nin düzenini açıklayan ATL_URL_SCHEME değerini döndürür.
CUrl::GetSchemeName
URL düzeni adını almak için bu yöntemi çağırın.
inline LPCTSTR GetSchemeName() const throw();
Dönüş Değeri
URL düzeni adını ("http" veya "ftp" gibi) döndürür.
CUrl::GetSchemeNameLength
URL düzeni adının uzunluğunu almak için bu yöntemi çağırın.
inline DWORD GetSchemeNameLength() const throw();
Dönüş Değeri
URL düzeni ad uzunluğunu döndürür.
CUrl::GetUrlLength
URL uzunluğunu almak için bu yöntemi çağırın.
inline DWORD GetUrlLength() const throw();
Dönüş Değeri
URL uzunluğunu döndürür.
CUrl::GetUrlPath
URL yolunu almak için bu yöntemi çağırın.
inline LPCTSTR GetUrlPath() const throw();
Dönüş Değeri
URL yolunu döndürür.
CUrl::GetUrlPathLength
URL yol uzunluğunu almak için bu yöntemi çağırın.
inline DWORD GetUrlPathLength() const throw();
Dönüş Değeri
URL yolu uzunluğunu döndürür.
CUrl::GetUserName
URL'den kullanıcı adını almak için bu yöntemi çağırın.
inline LPCTSTR GetUserName() const throw();
Dönüş Değeri
Kullanıcı adını döndürür.
CUrl::GetUserNameLength
Kullanıcı adının uzunluğunu almak için bu yöntemi çağırın.
inline DWORD GetUserNameLength() const throw();
Dönüş Değeri
Kullanıcı adı uzunluğunu döndürür.
CUrl::operator =
Belirtilen CUrl nesneyi geçerli CUrl nesneye atar.
CUrl& operator= (const CUrl& urlThat) throw();
Parametreler
urlThat
CUrl Geçerli nesneye kopyalanacak nesne.
Dönüş Değeri
Geçerli nesneye bir başvuru döndürür.
CUrl::SetExtraInfo
URL'nin ek bilgilerini (metin veya # metin gibi) ayarlamak için bu yöntemi çağırın.
inline BOOL SetExtraInfo(LPCTSTR lpszInfo) throw();
Parametreler
lpszInfo
URL'ye eklenecek ek bilgileri içeren dize.
Dönüş Değeri
Başarılı olduğunda TRUE, hatada YANLIŞ döndürür.
CUrl::SetHostName
Konak adını ayarlamak için bu yöntemi çağırın.
inline BOOL SetHostName(LPCTSTR lpszHost) throw();
Parametreler
lpszHost
Ana bilgisayar adı.
Dönüş Değeri
Başarılı olduğunda TRUE, hatada YANLIŞ döndürür.
CUrl::SetPassword
Parolayı ayarlamak için bu yöntemi çağırın.
inline BOOL SetPassword(LPCTSTR lpszPass) throw();
Parametreler
lpszPass
Parola.
Dönüş Değeri
Başarılı olduğunda TRUE, hatada YANLIŞ döndürür.
CUrl::SetPortNumber
Bağlantı noktası numarasını ayarlamak için bu yöntemi çağırın.
inline BOOL SetPortNumber(ATL_URL_PORT nPrt) throw();
Parametreler
nPrt
Bağlantı noktası numarası.
Dönüş Değeri
Başarılı olduğunda TRUE, hatada YANLIŞ döndürür.
CUrl::SetScheme
URL düzenini ayarlamak için bu yöntemi çağırın.
inline BOOL SetScheme(ATL_URL_SCHEME nScheme) throw();
Parametreler
nScheme
Düzenin ATL_URL_SCHEME değerlerinden biri.
Dönüş Değeri
Başarılı olduğunda TRUE, hatada YANLIŞ döndürür.
Açıklamalar
Şemayı ada göre de ayarlayabilirsiniz (bkz . CUrl::SetSchemeName).
CUrl::SetSchemeName
URL düzeni adını ayarlamak için bu yöntemi çağırın.
inline BOOL SetSchemeName(LPCTSTR lpszSchm) throw();
Parametreler
lpszSchm
URL düzeni adı.
Dönüş Değeri
Başarılı olduğunda TRUE, hatada YANLIŞ döndürür.
Açıklamalar
Şemayı ATL_URL_SCHEME sabiti kullanarak da ayarlayabilirsiniz (bkz. CUrl::SetScheme).
CUrl::SetUrlPath
URL yolunu ayarlamak için bu yöntemi çağırın.
inline BOOL SetUrlPath(LPCTSTR lpszPath) throw();
Parametreler
lpszPath
URL yolu.
Dönüş Değeri
Başarılı olduğunda TRUE, hatada YANLIŞ döndürür.
CUrl::SetUserName
Kullanıcı adını ayarlamak için bu yöntemi çağırın.
inline BOOL SetUserName(LPCTSTR lpszUser) throw();
Parametreler
lpszUser
Kullanıcı adı.
Dönüş Değeri
Başarılı olduğunda TRUE, hatada YANLIŞ döndürür.