My.WebServices Nesnesi

  • Makale

Geçerli proje tarafından başvuruda bulunılan her XML Web hizmetinin tek bir örneğini oluşturmak ve bunlara erişmek için özellikler sağlar.

Açıklamalar

nesnesi, My.WebServices geçerli proje tarafından başvuruda bulunılan her Web hizmetinin bir örneğini sağlar. Her örnek isteğe bağlı olarak oluşturulur. Nesnenin My.WebServices özellikleri aracılığıyla bu Web hizmetlerine erişebilirsiniz. Özelliğin adı, özelliğin eriştiği Web hizmetinin adıyla aynıdır. öğesinden SoapHttpClientProtocol devralan tüm sınıflar bir Web hizmetidir. Projeye Web hizmetleri ekleme hakkında bilgi için bkz . Uygulama Web Hizmetlerine Erişme.

My.WebServices nesnesi yalnızca geçerli projeyle ilişkili Web hizmetlerini kullanıma sunar. Başvuruda bulunılan DLL'lerde bildirilen Web hizmetlerine erişim sağlamaz. DLL'nin sağladığı bir Web hizmetine erişmek için, DllName biçiminde Web hizmetinin tam adını kullanmanız gerekir.WebServiceName. Daha fazla bilgi için bkz . Uygulama Web Hizmetlerine Erişme.

Nesnesi ve özellikleri Web uygulamaları için kullanılamaz.

Properties

nesnesinin My.WebServices her özelliği, geçerli proje tarafından başvuruda bulunılan bir Web hizmeti örneğine erişim sağlar. Özelliğin adı, özelliğin eriştiği Web hizmetinin adıyla aynıdır ve özellik türü Web hizmetinin türüyle aynıdır.

Not

Ad çakışması varsa, Bir Web hizmetine erişim için özellik adı RootNamespace_Namespace_ServiceName'dir. Örneğin, adlı Service1iki Web hizmetini göz önünde bulundurun. Bu hizmetlerden biri kök ad alanında ve ad alanındaysa WindowsApplication1Namespace1, kullanarak My.WebServices.WindowsApplication1_Namespace1_Service1bu hizmete erişebilirsiniz.

Nesnenin My.WebServices özelliklerinden birine ilk kez eriştiğinde, Web hizmetinin yeni bir örneğini oluşturur ve depolar. Bu özelliğin sonraki erişimleri, Web hizmetinin bu örneğini döndürür.

Bu Web hizmetinin özelliğine atayarak Nothing bir Web hizmetini atabilirsiniz. Özellik ayarlayıcısı depolanan değere atar Nothing . özelliği dışında Nothing bir değer atarsanız, ayarlayıcı bir ArgumentException özel durum oluşturur.

nesnesinin bir özelliğinin My.WebServices veya IsNot işlecini kullanarak Is Web hizmetinin bir örneğini depolayıp depolamadığını test edebilirsiniz. Özelliğin Nothingdeğerinin olup olmadığını denetlemek için bu işleçleri kullanabilirsiniz.

Not

Genellikle, karşılaştırmayı Is gerçekleştirmek için veya IsNot işlecinin özelliğinin değerini okuması gerekir. Ancak, özelliği şu anda depolarsa Nothing, özelliği Web hizmetinin yeni bir örneğini oluşturur ve bu örneği döndürür. Ancak, Visual Basic derleyicisi nesnenin My.WebServices özelliklerini özel olarak ele alır ve veya IsNot işlecinin Is değerini değiştirmeden özelliğin durumunu denetlemesine izin verir.

Örnek

Bu örnek, XML Web hizmetinin yöntemini TemperatureConverter çağırır FahrenheitToCelsius ve sonucu döndürür.

Function ConvertFromFahrenheitToCelsius(
    ByVal dFahrenheit As Double) As Double

    Return My.WebServices.TemperatureConverter.FahrenheitToCelsius(dFahrenheit)
End Function

Bu örneğin çalışması için projenizin adlı Converterbir Web hizmetine başvurması ve Bu Web hizmetinin yöntemini kullanıma sunması ConvertTemperature gerekir. Daha fazla bilgi için bkz . Uygulama Web Hizmetlerine Erişme.

Bu kod bir Web uygulaması projesinde çalışmaz.

Gereksinimler

Proje Türüne Göre Kullanılabilirlik

Proje türü Kullanılabilir
Windows Uygulaması Evet
Sınıf Kitaplığı Evet
Konsol Uygulaması Evet
Windows Denetim Kitaplığı Evet
Web Denetim Kitaplığı Evet
Windows Hizmeti Evet
Web Sitesi Hayır

Ayrıca bkz.